Retrieves or sets a value indicating whether the cell is painted using one
line, or more than one line.
| Type | Description | ||
| Item as Variant | A long expression that indicates the item's handle. | |||
| ColIndex as Variant | A long expression that indicates the cell's handle or the column's index, a string expression that indicates the column's caption or the column's key. | |||
| Boolean | A boolean expression that indicates whether the cell displays its caption using one or more lines. |
The control is able to display a cell using more lines. When the CellSingleLine is False, the height of the item is computed based on each caption in the item. By default the cell uses only a line to display its caption. Use the <br> HTML tag inside the CellCaption to break a line, if the CellCaptionFormat property is exHTML. Use the Def property to specify that all cells in the column use multiple lines. If your control displays items with different heights the ScrollBySingleLine property should be True. Use the CellVAlignment property to specify the vertical cell's alignment. Use the ItemMaxHeight property to specify the maximum value for the item's height. Use the ItemAllowSizing property to specify whether the user can resize the item at runtime.
The following VB sample displays the caption of the focused cell using multiple lines:
With ComboBox1.Items
.CellSingleLine(.FocusItem, 0) = True
End With
The following C++ sample displays the caption of the focused cell using multiple lines:
#include "Items.h" CItems items = m_combobox.GetItems(); items.SetCellSingleLine( COleVariant( items.GetFocusItem() ), COleVariant( long(0) ), FALSE );
The following VB.NET sample displays the caption of the focused cell using multiple lines:
With AxComboBox1.Items
.CellSingleLine(.FocusItem, 0) = False
End With
The following C# sample displays the caption of the focused cell using multiple lines:
axComboBox1.Items.set_CellSingleLine(axComboBox1.Items.FocusItem, 0, false);
The following VFP sample displays the caption of the focused cell using multiple lines:
with thisform.ComboBox1.Items .DefaultItem = .FocusItem .CellSingleLine( 0, 0 ) = .f. endwith
Note: The intersection of an item with a column defines a cell. Each cell is uniquely represented by its handle. The cell's handle is of HCELL type, that's equivalent with a long type. All properties of Items object that have two parameters Item and ColIndex, refer a cell.
The following lines are equivalents and each of them changes the bold font attribute of the first cell on the first item.
With ComboBox1 .Items.CellBold(, .Items.ItemCell(.Items(0), 0)) = True .Items.CellBold(.Items(0), 0) = True .Items.CellBold(.Items(0)) = True .Items.CellBold(.Items.ItemByIndex(0)) = True .Items.CellBold(.Items.ItemByIndex(0), 0) = True .Items.CellBold(.Items(0), ComboBox1.Columns(0).Caption) = True End With