| Allegro CL version 6.2 Unrevised from 6.1 |
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.
Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.
| Allegro CL version 6.2 Unrevised from 6.1 |