[This is preliminary documentation and subject to change.]
This control is a drop-down combo box with an edit field. It makes a predefined list of values and also allows for the user to enter some new value. It reads the possible values from the ComboBox Table. If the sorted style is set, the items are displayed according the Ordering column of the table. If the style is not set, that column is ignored and the items are displayed in alphabetical order.
The length of the text that can be entered can be limited by putting a number from 0 to 2147483646 in curly braces at the beginning of the Text field in the Control Table. For example if the text field starts with {80}, the length of the string is limited at 80 characters. If no such limit is supplied in the table, or if 0 is specified,the length is set to the maximum possible (2147483646 characters). A negative or non-numeric value will generate an error.
The property associated with this control can be integer or string valued.
ComboList
Enabled
Indirect
Integer
Sorted
Sunken
Visible
Default
Enabled
Indirect
IndirectPropertyName
Position
PropertyName
PropertyValue
Text
Visible
WindowHandle
None.
Windows: Yes.
The control is created with the "COMBOBOX" class with the CBS_AUTOHSCROLL, WS_TABSTOP, WS_GROUP, WS_CHILD styles. If the ComboList style bit is on, it also has the CBS_DROPDOWNLIST style, otherwise it has the CBS_DROPDOWN style.
If the Sorted style is set, it also has the CBS_SORT style.
For compatibility with screenreaders, when authoring a dialog with an ComboBox control as the first active control, you must make the text field belonging to the edit field the first active control in the Dialog Table. Since the static text cannot take focus, when the dialog is created the edit field will have the focus initially as intended, but doing this ensures that screenreaders show the correct information.