UserDialog Items

Item

Description

Properties

GroupBox

A rectangle used to group related controls

Field, Caption

Text

A text label, requires no response from the user

Field, Caption

TextBox

An edit box used to enter and edit text

Field, Type (single line, multiple line, password)

CheckBox

A box which is checked and unchecked as the user clicks on it, a three-state check box has a disabled (grayed) state

Field, Caption, Type (2 state, 3 state, 3 state auto check)

OptionButton

A round button for choosing from a set of options, only one of a group of option buttons may be checked

Field, Caption, Option Group

ListBox

A window that contains a list of items that can be selected by the user

Field, Array of Items, Type (list, sorted list)

DropListBox

A list that is visible when opened by the user, the text may be editable or not and the list may be sorted or not

Field, Array of Items, Type (list, text, sorted list, sorted text)

ComboBox

A text box with an attached list box, the list may be sorted or not

Field, Array of Items, Type (text, sorted)

Picture

Displays a bitmap in the dialog

Field, Caption, Type (from file, from clipboard)

PushButton

A push button

Field, Caption

OKButton

Push button with the OK caption

Field

CancelButton

Push button with Cancel caption

Field

Dialog

Definition of dialog box

Dialog Function, Caption, Centered

 

Properties:

  • Dialog Function: The dialog function is the name of a special function that is called when various events happen in a dialog. Define a dialog function to control the behavior of a dialog and to retrieve its input.

  • Field Name: The field name is the name used to refer to a component.

  • Caption: The caption is the text displayed within a component.

  • Quoted: When not quoted, the caption property gives the name of variable that contains the text to display for the caption. When quoted, the caption property is the literal text to display.

  • Array of Items: The array of items is the name of a string array variable that contains the strings to display in a list. The array variable must be initialized before the dialog is invoked.

  • Type: The type is the behavior of some components varies depending on which option is selected. Refer to the online help for descriptions of the available component types.

  • Option Group: For option buttons, the field name is used to refer to a group of option buttons. Only one option button within a group may be checked.

  • Comment: A comment is the text to insert in the dialog definition block.

See Also

Creating Dialog Boxes

UserDialog Example

Getting User Input

Scripter BASIC Language

Object Hierarchy

Object List