add-component

Arguments: widget dialog &optional behind hidden

Adds the control specified by the widget argument to the dialog-window dialog.

The keyword arguments are:

• behind: if specified 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.)

• hidden: If specified true, the new control will be added to the dialog but its window will not appear until the program later expands it explicitly. If 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.