NAME

       Deck - a stack of interactors on top of each other

SYNOPSIS

       #include <InterViews/deck.h>

DESCRIPTION

       A  deck  is  a  scene  containing interactors that are conceptually stacked on top of each
       other.  Only one interactor is  visible  at  a  time.   A  deck  is  useful  to  implement
       ``paging''  through  a document, or where only one of several similar components should be
       visible at a time, as in applications using alternate tool pallets or menus with alternate
       entries.

       A  deck will try to stretch or shrink the visible interactor to fill the total space.  The
       natural size of a deck is the maximum of its components.

       A deck uses its perspective to specify which component is  visible.   The  components  are
       numbered  in  the  order  in  which they are inserted into the deck, starting with one.  A
       scroller or other interactor which operates on the perspective can be used to allow a user
       to specify the component to view.  Either horizontal or vertical scrolling can be used.

PUBLIC OPERATIONS

       Deck() Construct a new deck.

       void Insert(Interactor*)
              Add an interactor to the deck.

       void Change(Interactor*)
              Notify  the deck that an interactor's shape has changed.  If propagation is on, the
              deck recomputes its own shape and notifies its parent.

       void Remove(Interactor*)
              Take an interactor out of a deck.

       void Flip(int count = 1)
       void FlipTo(int position)
       void Top()
       void Bottom()
              Perform operations on the perspective to  specify  the  component  to  view.   Flip
              specifies  the  component  relative  to the current component.  A positive value of
              count specifies a component nearer to the ``bottom'' of the  deck  (the  components
              inserted  last),  and a negative value specifies a component nearer to the ``top''.
              FlipTo specifies a component by its absolute position  in  the  deck.   A  positive
              value  of  position  specifies  a position from the top, starting at 1.  A negative
              value specifies a position from the bottom, starting at -1.   Top  and  Bottom  are
              equivalent to FlipTo(1) and FlipTo(-1) respectively.

SEE ALSO

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