A CAPI interface.
A pane of interface .
Real numbers representing coordinates, or keywords or lists specifying an adjusted position.
A function or
display-dialog displays the CAPI interface
as a dialog box.
screen is the screen for the dialog to be displayed on.
A true value of
indicates that the dialog takes over all input to the application. Additionally, if
:dismiss-on-input then any user gesture (a button or key press) causes the dialog to disappear.
:dismiss-on-input works on platforms other than Motif. The default value of
owner specifies an owner window for the dialog. See Dialogs: Prompting for Input for details.
are numbers they specify the coordinates of the dialog. Alternatively
can be keywords like
:top, or lists like
(:bottom 50) and so on.. These values cause the dialog to be positioned relative to its owner in the same way as the
argument to pane-adjusted-position. The default location is at the center of the dialog's owner.
is non-nil, then it must be a function with a lambda list that accepts two arguments. The
function is called with the values that would normally be returned by
display-dialog. On Cocoa, passing
causes the dialog to be made as a window-modal sheet and
display-dialog returns immediately, leaving the dialog on the screen. The with-dialog-results macro provides a convenient way to create a
The values returned depend on how the dialog is dismissed. Typically a user gesture will trigger a call to abort-dialog, causing the values
nil to be returned or to exit-dialog causing the values
t to be returned, where
is the argument to exit-dialog. If
is non-nil, then the returned values are always
The CAPI also provides popup-confirmer which gives you the standard OK and Cancel button functionality.
callback-error-handler allows error handling in callbacks which is uniform across platforms, as described for popup-confirmer.
CAPI User Guide and Reference Manual (Macintosh version) - 25 Feb 2015