EDIT dialog element

Top  Previous  Next

Syntax:

 

DIALOG ADD,EDIT,<name>,<top>,<left>,<width>,<height>,<value>,<tooltip>,<styles>

Description:

This dialog element creates an edit (input) box at the position and size specified, containing the text <value>.

Styles:

In addition to user-defined styles to change the default font style and color, the following styles may be used with this dialog element:

CLICK

The element will generate a <name>CLICK event whenever it is clicked.

EXIT

The element will generate a <name>EXIT event when the input focus moves away from the element.

MULTI

This style makes the element into a multi-line editor, similar to Notepad.

PASSWORD

This style causes asterisks to be displayed for every character typed.

READONLY

This style makes the text displayed in the element read only.

SAVE <name> [VDS6]

The element will automatically save and restore the last value it contains in the default registry location, or in an INI file if one is being used. If <name> is not specified then the name of the dialog element will be used for the name of the registry or INI file value. Note: This option should not be used if the amount of text the element can contain could be very large.

SCROLL

This style applies if the dialog element is multi-line. It causes scroll bars to appear so that non word-wrapped text (or lines longer than the width of the element) can be viewed and edited.

TABS

This style allows tab characters to be entered when editing text. If it is not present (the default state) hitting Tab will cause focus to go to the next element in sequence, instead.

WRAP

This style applies if the dialog element is multi-line, and causes text to be word-wrapped within the boundaries of the element.

<cursor style>

The cursor will change to the named style when the pointer is over the dialog element. Valid styles are: NONE, ARROW, CROSS, IBEAM, SIZE, NESW, NS, NWSE, WE, UP, WAIT, DRAG, NODROP, HSPLIT, VSPLIT, MULTI, SQL, NO, HELP, HAND.

See also: