property ComboBox.LabelText as String
Specifies the HTML caption to be displayed in the control's label when SearchColumnIndex property points to a not-existing column, AdjustSearchColumn property in False, the SingleEdit property is True, and the Style property is DropDownList.

 TypeDescription 
   String A String expression that specifies the HTML caption being displayed on the control's label.  
By default, the LabelText property is empty. Use the LabelText property to specify the HTML caption being displayed on the control's label. 

The LabelText has effect only if you have: 

In other words, the LabelText property allows you to specify a custom text for the control's label no matter of what the user selected in the drop down portion of the control. 

For instance, you can allow multiple selection using the LabelText as you can build the list of cells being checked and put them in the LabelText property. 

The following screen shot shows the control's label displaying the list of checked items:

 

The following VB sample changes the LabelText property once a check box state is changed, and allow checking a cell once the user clicks an item:

Private Sub ComboBox1_CellStateChanged(ByVal Cell As EXCOMBOBOXLibCtl.HCELL)
    Dim s As String
    With ComboBox1
        For Each i In .Items
            With .Items
                If Not (.CellState(i, 0) = 0) Then
                    s = s + IIf(Len(s) = 0, "", ",") & .CellCaption(i, 0)
                End If
            End With
        Next
        .LabelText = " " & s & " "
    End With
End Sub

Private Sub ComboBox1_MouseUp(Button As Integer, Shift As Integer, X As Single, Y As Single)
    With ComboBox1
        Dim h As Long, c As Long, hit As HitTestInfoEnum
        h = .ItemFromPoint(-1, -1, c, hit)
        If Not (exHTCellCheck = (hit And exHTCellCheck)) Then
            With .Items
                .CellState(.FocusItem, 0) = (1 + .CellState(.FocusItem, 0)) Mod 2
            End With
        End If
    End With
End Sub

The following VB/NET sample changes the LabelText property once a check box state is changed, and allow checking a cell once the user clicks an item:

private void excombobox1_CellStateChanged(object sender, int Item, int ColIndex)
{
    string s = "";
    exontrol.EXCOMBOBOXLib.Items items = excombobox1.Items;
    for ( int i = 0; i < items.ItemCount; i++)
	{
        int h = items.get_ItemByIndex(i);
        if ( items.get_CellState(h,0) != 0 )
            s = s + (s.Length == 0 ? "": ",") + items.get_CellCaption(h, 0);
	}
    excombobox1.LabelText = " " + s + " ";
}

private void excombobox1_MouseUpEvent(object sender, short Button, short Shift, int X, int Y)
{
    int c = 0;
    exontrol.EXCOMBOBOXLib.HitTestInfoEnum hit = exontrol.EXCOMBOBOXLib.HitTestInfoEnum.exHTCell;
    int h = excombobox1.get_ItemFromPoint(-1, -1, ref c, ref hit);
    if (exontrol.EXCOMBOBOXLib.HitTestInfoEnum.exHTCellCheck != (hit & exontrol.EXCOMBOBOXLib.HitTestInfoEnum.exHTCellCheck)) 
    {
        exontrol.EXCOMBOBOXLib.Items items = excombobox1.Items;
        items.set_CellState(items.FocusItem, 0, (1 + items.get_CellState(items.FocusItem, 0)) % 2);
    }
}

The LabelText property supports the following HTML tags:


Send comments on this topic.
1999-2017 Exontrol.COM, Software. All rights reserved.