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)

InterViews  —  Last change: 13 December 1987