dialog.setValue
| Syntax |
dialog.setValue (itemnumber, val)
|
| Params |
itemnumber is the number of a dialog item in a dialog defined using Macintosh resources. val is the value to be assigned to the specified item. (See Action for details.)
|
| Action |
Sets the value of the indicated dialog itemnumber to val. The type of data expected in val depends on the nature of the item identified by itemnumber: check box, or radio button: val is interpreted as a Boolean. a control, like a scrollbar: val is interpreted as a short number. a text item: val is interpreted as a string. a button: val is interpreted as a string containing the button's new title.
|
| Returns |
True
|
| Examples |
dialog.setValue (1, "Hello!") » true
|
| Platform Notes |
This verb is only implemented in the Mac OS version of Frontier.
|
| 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.
|
| 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.getValue
|
