Deck(3I)						    InterViews Reference Manual 						  Deck(3I)

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 com-
       ponents.

       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 compo-
	      nent.  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)

InterViews							 13 December 1987							  Deck(3I)