Retrieves or sets a value indicating whether the cell has an
associated push button.
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 contains a button. |
The CellHasButton property specifies whether the cell display a button inside. When the cell's button is clicked the control fires CellButtonClick event. The caption of the push button is specified by the CellCaption property. Use the Def property to assign buttons for all cells in the column.
The following VB sample sets the cells of the first column to be of button type, and displays a message when one of them has been clicked.
Private Sub ComboBox1_InsertItem(ByVal Item As EXCOMBOBOXLibCtl.HITEM) ComboBox1.Items.CellHasButton(Item, 0) = True End Sub Private Sub ComboBox1_CellButtonClick(ByVal Cell As EXCOMBOBOXLibCtl.HCELL) MsgBox "The user clicks the cell's button. " & ComboBox1.Items.CellCaption(, Cell) End Sub
The following VB sample assigns a button to the focused cell:
With ComboBox1.Items .CellHasButton(.FocusItem, 0) = True End With
The following C++ sample assigns a button to the focused cell:
#include "Items.h" CItems items = m_combobox.GetItems(); items.SetCellHasButton( COleVariant( items.GetFocusItem() ), COleVariant( (long)0 ), TRUE );
The following VB.NET sample assigns a button to the focused cell:
With AxComboBox1.Items .CellHasButton(.FocusItem, 0) = True End With
The following C# sample assigns a button to the focused cell:
axComboBox1.Items.set_CellHasButton(axComboBox1.Items.FocusItem, 0, true);
The following VFP sample assigns a button to the focused cell:
with thisform.ComboBox1.Items .DefaultItem = .FocusItem .CellHasButton(0,0) = .t. 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