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 elements 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 interactors 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)