ask-user-for-choice

Function

Package: common-graphics

Arguments: prompt button1 &optional button2 button3 button4 title stream&key topmost

This is another version of pop-up-message-dialog. A dialog is displayed with as many buttons (one, two, or three) as are specified non-nil. The user clicks on a button and the value of that button (the value specified as the argument) is returned. If the user cancels the dialog bu clicking on the close box, nil is returned.

The arguments are:

prompt: should be a string. It will be displayed in the dialog.
button1: the value can be a symbol or a string anming the button, or a list whose first element is a symbol or string naming the button and whose second element is a help string. The button is labeled with the string or the print name of the symbol. If a help string is provided, it is displayed in the status bar when the cursor is over the button. If the user clicks on this button, the arguments value (a symbol, a string, or a list of a symbol or string and a string) is returned.
button2 and button3: the value can be a symbol or a string anming the button, or a list whose first element is a symbol or string naming the button and whose second element is a help string, or nil. If the value is nil, the button is not displayed. The button is labeled with the string or the print name of the symbol. If a help string is provided, it is displayed in the status bar when the cursor is over the button. If the user clicks on this button, the arguments value (a symbol, a string, or a list of a symbol or string and a string) is returned.
title: this argument provides the title for the dialog. Its value should be a string. Note that all optional button arguments must be specified to supply a title (to preserve backward compatibility). Specify nil for a button that should not be displayed. If no title is specified, none is used.
stream: the owning window of the dialog; defaults to the currently selected top-level window, if any, and otherwise the screen. Note that all optional button arguments and the title must be specified to supply stream. Specify nil for a button that should not be displayed and for title if you want no title.
topmost: when this argument is true, the utility dialog invoked by this function will be topmost while it is present. A topmost window is one that remains on top of all other non-topmost windows, even those in other applications. This feature is particularly useful for modal dialogs that need to alert the user even if they have switched to another application. Note that all optional arguments must be specified to specify a value for topmost.

The position of the dialog when displayed is controlled by position-utility-dialog.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Created 2000.10.5.