Type | Description | |||
String | A String expression that specifies the HTML caption being displayed on the control's label. |
The LabelText property has effect only if:
If:
the LabelText property specifies the HTML format to display the count of selected items By default (if empty), the format is "(%c)" which displays the number of selected items between () parenthesis. For instance, "<bgcolor=000000><fgcolor=FFFFFF> %c </fgcolor></bgcolor>" shows the count of selected items in white on a black-background. The " " prevents showing the count of selected items
The following screen show shows the control's label (multiple-selection)
If:
the LabelText property specifies the HTML caption to show within the control's label (for instance, displays the list of checked-items, as soon as user changes the cell's state)
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:
The control supports expandable HTML captions feature which allows you to expand(show)/collapse(hide) different information using <a ;exp=> or <a ;e64=> anchor tags. The exp/e64 field of the anchor stores the HTML line/lines to show once the user clicks/collapses/expands the caption.
Any ex-HTML caption can be transformed to an expandable-caption, by inserting the anchor ex-HTML tag. For instance, <solidline><b>Header</b></solidline><br>Line1<r><a ;exp=show lines>+</a><br>Line2<br>Line3 shows the Header in underlined and bold on the first line and Line1, Line2, Line3 on the rest. The show lines is shown instead of Line1, Line2, Line3 once the user clicks the + sign.
or <font ;31><sha 404040;5;0><fgcolor=FFFFFF>outline anti-aliasing</fgcolor></sha></font> gets: