TCustomComboBox is a TWinControl descendant which @@ -1604,10 +1606,10 @@ Component Library).
A combo-box is visually represented as an edit control and a scrollable list -of items which can be selected. The list can be always visible, or opened -when needed using a drop-down indicator. In addition, the items in the -control be drawn using using the built-in mechanisms for the widgetset class -or using an owner-drawn style. +of items which can be selected. The list can always be visible, or opened +when needed using a drop-down indicator. In addition, the items displayed on +the control be drawn using using the built-in mechanisms for the widgetset +class or using an owner-drawn style.
Despite similarities in appearance to TCustomEdit and @@ -1615,19 +1617,38 @@ Despite similarities in appearance to TCustomEdit and (Delphi compatible).
-Use the Style property to control the display style and drawing -mechanism enabled for Items in the control. +Use Items to access the entries displayed in the drop-down list. Use +AddItem or AddHistoryItem to add entries to +the list of items. Use OnGetItems to dynamically populate the Items +in the control when the drop-down list is displayed.
-Use properties like AutoComplete, AutoCompleteText, and -AutoDropDown to control the behavior of the edit field or -drop-down list in the control. +The selectable values in Items can be maintained at design-time by +clicking on the ellipsis character (...) displayed next to Items in the +Object Inspector.
-Use Items to access existing list items defined the control. Use -AddItem or AddHistoryItem to add entries to the list -items in the control. Use OnGetItems to dynamically populate the -Items in the control when the drop-down list is displayed. +The Text property reflects the text entered directly into the edit +box, or selected either manually or by auto-completion from the Items in the +list. At run-time, the entry selected from the list replaces the text in the +edit box, and ItemIndex holds the (zero-based) index number of the +selected item. If no value is selected from the drop-down list, the default +text (if any) remains for any information typed directly into the control Text, +and ItemIndex takes the value of -1. +
++Use Style to control the display style and drawing mechanism enabled +for the drop-down list on the control. +
++Use AutoDropDown, AutoComplete, +AutoCompleteText, and AutoDropDown to control the +behavior of the edit box and its interaction with the drop-down list on the +control. +
++Use ItemHeight and ItemWidth to control the appearance +for the Items displayed on the drop-down list.
Do not create instances of TCustomComboBox. Use one of the descendent @@ -1635,10 +1656,19 @@ classes, like TComboBox or TComboBoxEx.
-The Text property reflects the text entered into the edit box, or selected -from the list. +TComboBox is a TCustomComboBox descendant which +implements the a combo-box component in the LCL (Lazarus Component Library).
-The selectable values are kept in the Items list. Clicking on the -ellipsis character (...), next to Items in the Object -Inspector, opens an editor which allows the designer to populate the Items -list. +A combo-box is visually represented as an edit control and a scrollable list +of items which can be selected. The list can always be visible, or opened +when needed using a drop-down indicator. In addition, the items displayed on +the control be drawn using using the built-in mechanisms for the widgetset +class or using an owner-drawn style.
-At run-time, the entry selected from the list replaces the text in the edit -box, and ItemIndex holds the (zero-based) index number of the -selected item. +Despite similarities in appearance to TCustomEdit and +TCustomList, the class inherits no properties from these classes +(Delphi compatible).
-If no value is selected from the drop-down list, the default text (if any) -remains, or any information typed directly into Text will be -returned, and ItemIndex takes the value of -1. +Use Items to access the entries displayed in the drop-down list. Use +AddItem or AddHistoryItem to add entries to +the list of items. Use OnGetItems to dynamically populate the Items +in the control when the drop-down list is displayed. +
++The selectable values in Items can be maintained at design-time by +clicking on the ellipsis character (...) displayed next to Items in the +Object Inspector. +
++The Text property reflects the text entered directly into the edit +box, or selected either manually or by auto-completion from the Items in the +list. At run-time, the entry selected from the list replaces the text in the +edit box, and ItemIndex holds the (zero-based) index number of the +selected item. If no value is selected from the drop-down list, the default +text (if any) remains for any information typed directly into the control Text, +and ItemIndex takes the value of -1. +
++Use Style to control the display style and drawing mechanism enabled +for the drop-down list on the control. +
++Use AutoDropDown, AutoComplete, +AutoCompleteText, and AutoDropDown to control the +behavior of the edit box and its interaction with the drop-down list on the +control. +
++Use ItemHeight and ItemWidth to control the appearance +for the Items displayed on the drop-down list.