NAME¶
Adjuster - button-like interactors for incremental scrolling and zooming
SYNOPSIS¶
#include <InterViews/adjuster.h>
DESCRIPTION¶
Adjuster objects manipulate a perspective using a pushbutton-like
interface. Adjusters also provide an auto-repeat capability. Depressing and
holding down any mouse button on an adjuster for a specified time causes it to
repeatedly perform its operation. The auto-repeat terminates when the button
is released.
Predefined subclasses of Adjuster include Zoomer and
Mover. Zoomers adjust the perspective's curwidth and
curheight members to suggest magnification. The user clicks on a
zoomer to magnify or reduce the contents of the interactor through its
perspective. The Enlarger zoomer subclass halves the perspective
values while the Reducer class doubles them. Movers provide an
incremental movement of the perspective in one of four directions; left,
right, down, or up. The user clicks on a mover to move the perspective.
PUBLIC OPERATIONS¶
- Adjuster(Interactor*, int = NO_AUTOREPEAT)
- Adjuster constructors take a pointer to the interactor whose perspective
will be adjusted and a delay (in tenths of a second) after which
auto-repeat will begin once the adjuster is ``pressed''.
- virtual void Highlight()
- virtual void UnHighlight()
- These functions define how the adjuster draws itself when it is pressed.
The adjuster is highlighted when it is pressed with any mouse button and
unhighlighted when the button is released. The default is to invert the
adjuster when highlighted.
PROTECTED OPERATIONS¶
- virtual void AdjustView(Event&)
- This function defines how the adjuster adjusts the interactor's
perspective. It is called after the adjuster is pressed and released, or
repeatedly during auto-repeat. Derived classes should redefine this
function to implement the desired behavior.
DERIVED CLASSES¶
- Enlarger(Interactor*)
- Reducer(Interactor*)
- Enlargers and reducers adjust an interactor's perspective to enlarge and
reduce the visible area by factors of one half and two, respectively. This
suggests to an interactor to enlarge or reduce its contents. Auto-repeat
is disabled on these adjusters.
- LeftMover(Interactor*, int delay = NO_AUTOREPEAT)
- RightMover(Interactor*, int delay = NO_AUTOREPEAT)
- DownMover(Interactor*, int delay = NO_AUTOREPEAT)
- UpMover(Interactor*, int delay = NO_AUTOREPEAT)
- These subclasses of Mover adjust the current origin of the
interactor's perspective by an amount in the corresponding direction. If
the shift key is down while the mover is pressed, the amount corresponds
to the perspective's lx or ly member variables; otherwise,
the sx or sy values are used.
SEE ALSO¶
Interactor(3I), Perspective(3I)