| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: widget dialog &optional behind hidden
Adds the control specified by the widget argument to the dialog-window dialog.
The keyword arguments are:
t
,
the new control will be placed behind the other sibling widgets in the
occlusion stack. If nil
(the default), the
new control will be in front of the others and be first in the tab
order. A value other than t
or nil
must be a sibling widget on
dialog. The new widget will be placed behind that
one in the occlusion stack.
When creating many widgets by calling add-component for each one, it may
be more efficient to pass behind as t
for each one, because the operating system creates
child windows in back initially, and also there will be no movement of
the keyboard focus to each new widget as it is created as there is
when each one is added in front (if the parent window has already been
expanded). (When creating the widgets instead by passing a list of the
widgets as the :dialog-items initarg to make-window, they are added to the
parent window in front-to-back order internally.)
nil
(the default), the new
control will appear with the dialog.
widget is returned.
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 |