Arguments: configuration
Returns (or sets with setf) the value of the center-all-modal-dialogs-on-screen configuration property.
This property affects modal dialogs displayed by utility functions such as ask-user-for-choice-from-list. Modal dialogs created by application code can be positioned wherever the application likes before they are shown. But applications do not have a handle on built-in modal dialogs and so cannot specify their positions directly. This property gives some measure of control over the placement of such dialogs.
The value of this property of the current configuration can be t, nil, or
:on-owner, which is the default. (Note: in releases
prior to 6.0, the default was nil. The
:on-owner value was added as a possibility in
release 6.0.)
If the value is :on-owner, the dialog is centered
on the owner window that the application passes to the various utility
dialog functions. Such modal dialogs are displayed by functions like
ask-user-for-choice-from-list.
If the value is t (or, indeed, any
true value other than
:on-owner), modal dialogs are positioned in the
center of the screen (absent overriding specification of another
location). If the value is nil, modal dialogs
are placed near the upper left corner of the owner.
Note that for Common Dialogs (implemented by the operating system and
invoked by functions such as ask-user-for-new-pathname), Common
Graphics does not know how large the dialogs are and therefore cannot
center them; therefore, for Common Dialogs, the
:on-owner option behaves like nil to position the dialogs at or near the upper left
corner of the owner window.
The
current configuration is the value of (configuration*system*).
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.