GetChoice

The GetChoice function opens a dialog showing a binary choice 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.

Syntax

nChoice, bSuccess = GetChoice( sLabels )

nChoice, bSuccess = GetChoice( sLabels, n )

nChoice, bSuccess = GetChoice( sLabels, n, sPrompt )

nChoice, bSuccess = GetChoice( sLabels, n, sPrompt, sTitle )

where

    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 chosen.

    sPrompt specifies a message above the choices. If nil, a default is used.

    sTitle specifies the window title. If nil, a default is used.

    bSuccess is an optional success flag. If [OK] is clicked, the function returns nChoice=1 or 2, and bSuccess=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

     "First label\nSecond label".

The choice is returned as nResult = 1 or 2. If the User clicks [OK], then this method returns bSuccess=true. Otherwise, if the user clicks [Cancel], then this method returns bSuccess=false.

Examples

The dialog shown above was created using the following code:

A default dialog that specifies strings and title would use the following code:

A default dialog with only the strings specified might code like this (you can skip the intermediate nil's:

Related Topics

GetItem

GetTrueFalse