Scripting Additions Guide

CHAPTER 2
Scripting Addition Commands
24 Command Definitions
buttonNumberOrName
The default button. You can specify the default button with a
string (the string provided for the button in buttonList) or with
an integer (which specifies the position of the button in the
buttonList list; 1 specifies the first button from the left, 2 specifies
the second button from the left, and so on).
Class: String or integer
iconNumberOrName
The icon to be included in the dialog box. This can be either a
string that specifies the name of an 'ICON' resource or an
integer that specifies the number of the resource (see “Notes”).
Class: String
RESULT
A record of object class Reply (defined by the Display Dialog scripting
addition) that contains the following properties:
button returned
The text of the button the user pressed to close the dialog box.
Class: String
text returned
The text from the editable text field in the dialog box. If the
dialog does not include an editable text field, no string is
returned. If there is no text in the field, the value is the empty
string ("").
Class: String
EXAMPLE
The following example uses the Display Dialog command to prompt the user
for a password.