lisp-group-box

Class

Package: common-graphics

Class

The class of a lisp-group-box control.

Control

Draws a black titled box of specified size. Used to group items. Note that though this widget appears as a simple line around other widgets, it is actually an opaque area. Therefore, you need to insure that any widgets appearing inside the group-box are displayed after the group-box is (since otherwise they will be buried behind the opaque group-box). The buried widgets will be invisible.

The order in which you need to list the widgets depends on when you create them. If you are passing in a list of widgets to make-window, the group-box should come after the items inside it. If, on the other hand, you are adding individual widgets to a dialog box that already exists, the group-box must be added before the items inside it are added.

If the title property of a lisp-group-box is either nil or the null string, then no title is drawn and the border forms a complete rectangle. Also, the top edge of the group box will move up to the top edge of the group box's region (rather than being a bit lower as usual to align with the vertical center of the title text).

If either the width or the height of a lisp-group-box is less than 20, then the group box will be drawn as a single vertical or horizontal line (respectively) instead of as a narrow box, and the title will not be drawn. The single line will still have a 3D look as long as the border is :raised-edge or :sunken-edge.

See About how to get sample code for creating controls in cgide.htm, which explains how to use the IDE to create such code.

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.