Box(3I) 						    InterViews Reference Manual 						   Box(3I)

NAME

       Box, HBox, VBox - tile interactors in a box

SYNOPSIS

       #include <InterViews/box.h>

DESCRIPTION

       A  box  is a scene of interactors that are tiled side-by-side in the available space.  Interactors are placed left-to-right in a horizontal
       box, and top-to-bottom in a vertical box.

       A box will try to stretch or shrink the interactors inside it to fit the available space.  The natural size of a box is the sum of its ele-
       ments  along the major axis, and the maximum along its minor axis.  A box's stretchability (shrinkability) is the sum of its elements along
       its major axis and the minimum of its elements along its minor axis.

PUBLIC OPERATIONS

       HBox(...)
       VBox(...)
	      Create a new box.  Zero to seven interactors may be passed as arguments; the interactors are inserted into the box.

       void Align(Alignment)
	      Set the alignment mode that the box uses to place elements along the minor axis.	The default alignment for an hbox is Bottom; other
	      choices are Top and Center.  The default alignment for a vbox is Left; other choices are Right and Center.

       void Insert(Interactor*)
	      Append  an interactor to the box.  Components of an hbox (vbox) will appear left-to-right (top-to-bottom) in the order in which they
	      are inserted.

       void Change(Interactor*)
	      Notify the box that the given interactor's shape has changed.  If change propagation is true, the box will modify its own  shape	to
	      reflect the change and notify its parent.  Regardless of propagation, the box will recompute the positions of the component interac-
	      tors and update any that have changed.

       void Remove(Interactor*)
	      Take an element of out a box.  Remove does not cause any immediate change to the other components in the box; the  Change  operation
	      must be called after one or more Removes to update the component positions.

SEE ALSO

       Glue(3I), Interactor(3I), Scene(3I), Shape(3I)

InterViews							   15 June 1987 							   Box(3I)