GetChoice
The GetChoice function opens a dialog showing two choices to be made. This function returns the choice index and the button that was clicked. All text labels can be configured or defaults can be used.
|
|
nChoice, bOK = GetChoice( sLabels )
nChoice, bOK = GetChoice( sLabels, n )
nChoice, bOK = GetChoice( sLabels, n, sPrompt )
nChoice, bOK = GetChoice( sLabels, n, sPrompt, sTitle )
sLabels is the list of choice labels, separated by \n.
n is the index of the initial choice (1 or 2). If nil, item 1 is initially chosen.
sPrompt specifies a message above the choices. If nil, a default prompt is used.
sTitle specifies the window title. If nil, a default title is used.
If [OK] is clicked, the function returns nChoice = 1 or 2, and bOK = true.
If the dialog is canceled, 1, false is returned.
All arguments following sLabels are optional. and assume default values after the last argument you specify. To use a default argument but follow it with a specified argument, use a nil in its place.
The sLabels argument specifies the strings to be used for the 2 bullet labels. These labels are specified in one string separated by a new line character \n, with the top label first. For example, to specify the labels as "First label" and "Second label", pass the sLabels argument as
The choice is returned as nResult = 1 or 2. If the User clicks [OK], then this method returns bOK=true. Otherwise, if the user clicks [Cancel], then this method returns bOK=false.
Example 1. The dialog shown above was created using the following code:
|
|
|
-- labels |
|
-- initial choice |
|
-- prompt |
|
-- dialog title |
Example 2. A default dialog that specifies strings and title would use the following code:
|
|
|
-- labels |
|
-- default initial choice |
|
-- default prompt |
|
-- dialog title |
Example 3. A default dialog with only the strings specified might code like this (you can skip the intermediate nil's:
|
-- labels only |
|
|
Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics,
Inc. All Rights Reserved.