| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
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.
If the typical conventions allowed by this configuration option are not adequate, the built-in utility dialogs can be positioned however you like by writing a position-utility-dialog method.
The value of this property of the current configuration can be t
, nil
, or
:on-owner
, which is the default.
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*)
. (See configuration and *system*
.)
See also position-utility-dialog
Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |