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.
Non-backward-compatible change in release 6.0: in earlier
releases, any true value was interpreted as
t is in 6.0: place the new widget behind all
others. In 6.0, only t has that meaning and
any other non-nil value must be another
sibling widget on dialog. Note too that this
optional argument was named in-back-p. The names
of optional arguments have no effect, of course, but the new name
behind describes the new behavior better than the
old.
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.
(In releases prior to 6.0, the hidden argument was named hidden-p. The names of optional arguments have no importance, of course, (unlike the names of keyword arguments). We note the name change only to make clear there is no change in functionality associated with this argument.)
widget is returned.
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.