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)