bionic (3) Box2_6.3I.gz

Provided by: ivtools-dev_1.2.11a1-11_amd64 bug

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)