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)