Skip to content

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