Button Syntax

Syntax

<[%Directives%][*][Width][,Height].Label[&]Label[=Variable][!Event][?Enabled]>

Argument

Type

Description

%Directives%

 

Refer to Xdialog Language Directives and Operators.
<>

C

The leading < and trailing > characters are required.
*

C

Optional. Indicates that this is the default button on the Xdialog.
Width

N

Optional. The width of the control.
Height

N

Optional. The height of the button in units (specified by the {UNITS} command).
&

C

Optional. Precedes the letter that is the hotkey for the button.
Label

C

The label of the button. The optional "=Variable" syntax allows you to use the contents of a variable as the button label.
Event

C

The name of the event generated by the button.
Enabled

L

Optional. See Enabled Syntax.

Description

One or more Button objects may appear inside the Format section of a UI_DLG_BOX() function.

Example

format = <<%dlg%

Hello World

<*Click Here> <Or Click Here>

%dlg%

ui_dlg_box("Simple Xdialog", format)

If you need to place ">" or "<" characters in the Enabled expression, they should be preceded by the "\" character. The following example enables the Next button only if the last_name and first_name field have non-null values. [Picture]

<Next?(last_name\>"" .and. first_name\>"")>

See Also

Xdialog Language Directives and Operators, Xdialog Control Reference

Supported By

Alpha Five Version 5 and Above