ComboBox

Syntax

ComboBox HorizPos, VertPos, Width, Height, ArrayVariable$(), .Identifier[$]

Remarks

Creates a combo box — a single control that is a combination of a list box and a text box — in a custom dialog box. A user can either select an item from the list or type a new item in the text box.

Argument

Explanation

HorizPos, VertPos

The horizontal and vertical distance of the upper-left corner of the combo box from the upper-left corner of the dialog box, in increments of 1/8 and 1/12 of the System font (Windows) or the dialog font (Macintosh).

Width, Height

The width and height of the combo box, in increments of 1/8 and 1/12 of the System font (Windows) or the dialog font (Macintosh).

ArrayVariable$()

A text array containing the items to be listed in the combo box.

.Identifier[$]

Together with the dialog record name, .Identifier[$] creates a variable whose value corresponds to the text of the item chosen or the text typed in the combo box. The form for this variable is DialogRecord.Identifier[$] (for example, dlg.MyComboBox$). The dollar sign ($) is optional; you can use it to indicate that the variable is a string variable.

The identifier string (.Identifier[$] minus the period) is also used by statements in a dialog function that act on the combo box, such as DlgEnable and DlgVisible.


The macro must define and assign values to the elements in ArrayVariable$() before defining the dialog box containing a combo box. To see an example of ComboBox in a dialog box definition, see Begin Dialog¼End Dialog.

See Also

Begin Dialog¼End Dialog, Dialog, Dim