Scroll to navigation

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 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

Construct a new deck.
Add an interactor to the deck.
Notify the deck that an interactor's shape has changed. If propagation is on, the deck recomputes its own shape and notifies its parent.
Take an interactor out of a deck.
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)

13 December 1987 InterViews