All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

display-replacable-dialog Function

Summary

Displays a replacable dialog.

Package

capi

Signature

display-replacable-dialog interface &rest args => result

Arguments
interface
An interface.
args
Other arguments as for display-dialog.
Values
result
The value returned by the dialog.
Description

The function display-replacable-dialog displays a dialog that can be replaced by another dialog.

interface is a CAPI interface to be displayed as a dialog.

The arguments args are interpreted the same as the arguments to display-dialog, except that modal is ignored. display-replacable-dialog displays the dialog like display-dialog.

Within the scope of display-replacable-dialog (that is, inside the callbacks) the programmer can call replace-dialog which replaces the dialog by a new dialog and destroys the existing one. There can be many calls to replace-dialog inside the same scope of display-replacable-dialog.

display-replacable-dialog returns the last dialog that was displayed.

Inside display-replacable-dialog, the functions that use the current dialog, such as exit-dialog and abort-dialog, work in the same way that they work inside display-dialog, except that they do not affect the return value of display-replacable-dialog.

See also

abort-dialog
display-dialog
exit-dialog
replace-dialog


CAPI User Guide and Reference Manual (Macintosh version) - 01 Dec 2021 19:31:27