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)
