Arguments: window &optional value
Tells the system that the user has completed interaction with a modal dialog, and so the dialog should go away and the call to pop-up-modal-dialog that invoked the modal dialog should now return. A call to flag-modal-completion is not a non-local exit like a throw; it merely sets a flag that is noticed asynchronously after the event-handling code that calls flag-modal-completion has exited.
Flag-modal-completion is called internally if the on-change event handler function
for a control returns a true second value, or if
the default on-change event handler function is used with a default-button or
cancel-button. An application can
also call Flag-modal-completion explicitly to end interaction with a
modal dialog. For example, the on-double-click event handler
function for an item-list control could call flag-modal-completion
with the value of the item-list to be returned from the call to
pop-up-modal-dialog.
window is the modal dialog. If window is not presently being invoked modally with pop-up-modal-dialog (see is-modal), then flag-modal-completion simply does nothing.
value is an arbitrary value that will be returned from pop-up-modal-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.
Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.
Created 2000.10.5.