dialog.getValue

Syntax dialog.getValue (itemnumber)

Params itemnumber is the number of a dialog item in a dialog defined using Macintosh resources.

Action Determines the value of dialog item itemnumber.

Returns The value of the indicated dialog item number

The type of value depends on the type of the item:

check box, or radio button: returns Boolean true or false

a control, like a scrollbar: returns a short number, the value of the control

a text item: returns a string

otherwise: a number, 0

Examples See the Frontier script dialog.getInt for an example of the use of this verb.
Errors If itemnumber is out of range for the dialog, an error results.

If you call this verb from a script that is not an itemhit handler (see "Notes," below, for details), an error results.

Platform Notes This verb is only implemented in the Mac OS version of Frontier.

Notes This is an advanced Frontier verb of primary interest to implementers and advanced scripters. It is not necessary to understand it to use Frontier effectively for most tasks.

This verb only works if there's a dialog box displayed. Thus it is valid only when called from a script that is an itemhit handler, whose address was passed to dialog.run or dialog.runModeless.

See Also dialog.run

dialog.runModeless

dialog.setValue

Discuss