All Manuals > CAPI Reference Manual > 1 CAPI Reference Entries

NextPrevUpTopContentsIndex

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 don't affect the return value of display-replacable-dialog .

See also

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


CAPI Reference Manual - 15 Dec 2011

NextPrevUpTopContentsIndex