TWebComboBox
Description
Below is a list of the most important properties methods and events for TWebComboBox
. A TWebComboBox
is a control having a list of (text) items, similar to a VCL TComboBox
.
![]() |
![]() |
---|---|
Designtime | Runtime |
HTML template tag
The HTML tag the component can be associated with in an HTML template. Assign the ID
attribute with a unique value and set the identical value to the ElementID
property. Detailed
information can be found in the Use of HTML templates topic.
HTML tag | <DIV ID=”UniqueID”></DIV> |
---|---|
ElementID | UniqueID |
The items in the combobox are mapped onto HTML OPTION elements of the SELECT element. This means there is also the capability to take advantage of the Name/Value settings of the OPTON element. This can be done by adding items via a Name/Value pair, i.e. text that is separated by the default NameValueSeparator "=". If this is not desired, set WebListBox.Items.NameValueSeparator to #0.
Properties for TWebComboBox
Property | Description |
---|---|
ElementClassName | Optionally sets the CSS classname for the label when styling via CSS is used |
ElementID | Optionally sets the HTML element ID for a HTML element in the form HTML file the label needs to be connected with. When connected, no new label is created but the Delphi class is connected with the existing HTML element in the form HTML file |
ItemIndex | Sets or gets the index of the selected item |
Items | Access to the items in the listbox as a TStringList |
Required | When true, the content of the TWebComboBox being empty will cause a validation popup when used on a TWebHTMLForm. Maps on HTML required attribute: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/required |
RequiredText | Sets the text to show when no valid text was entered |
| ShowFocus | When true
, the border color changes when the control has focus |
| TabOrder | Sets the tab order of the control |
| TabStop | When true
, the focus is turned to the control when pressing tab |
| Text | Gets or sets the selected value in the combobox |
|TextDirection|Sets the text direction to tdDefault
: does not use direction attribute tdInherit
: uses TextDirection
of parent control tdRightToLeft
: uses rtl direction attribute
`|
| Values[AIndex: integer]: string | Sets or gets the value attribute of the combobox OPTION element |
Events for TWebComboBox
Property | Description |
---|---|
OnChange | Event triggered when the selected item changes in the listbox |
OnClick | Event triggered when the listbox is clicked |
OnDblClick | Event triggered when the listbox is double-clicked |
OnEnter | Event triggered when the control gets focus |
OnExit | Event triggered when focus leaves the control |