Handling input events: interactors and accelerators

Interactors

An IlvManager instance responds to user actions according to the state of the manager when a certain input event occurs, and also according to the position and shape of the object that receives the event.

IlvManager actions can be either global (that is, applied to a whole view through instances of classes derived from IlvManagerViewInteractor) or local (applied to an object or a set of objects in a view through instances of classes derived from IlvObjectInteractor).

The manager associates an interactor object, that is, an instance of the IlvManagerViewInteractor class, with each view. This interactor object processes events that are intended for that particular view. If the manager has not associated an interactor object with a view, then each event is handled by the interactor object associated with the graphic object that received the event. In this case, the interactor object belongs to the IlvObjectInteractor class, which manages the events for a particular object.

Accelerators

If no object is indicated when the event is received, or, if it has no associated IlvObjectInteractor, the manager tries to apply an accelerator, which is a direct call of a user-defined action, such as the pressing of a certain key sequence. In fact, in certain situations, the best solution is to establish a generic action for all the objects associated with a single event sequence so that, for example, pressing Ctrl+Z causes the view to zoom. To do this, JViews allows you to associate direct actions with events. These actions, which are bound neither to the view nor to the object that was clicked, are called accelerators.

The JViews Framework provides a number of predefined accelerators:

Name	Description
IlvCycleSelectAccelerator	Selects the graphic objects one after another.
IlvSelectAllAccelerator	Selects or deselects all graphic objects.
IlvDeleteSelectionAccelerator	Deletes the currently selected object.
IlvDuplicateSelectionAccelerator	Duplicates the currently selected object.
IlvRotateSelectionAccelerator	Rotates the currently selected object.
IlvMoveSelectionAccelerator	Moves the currently selected object.
IlvPopupMenuAccelerator	Opens the pop-up menu on the currently selected object.
IlvExpandSelectionAccelerator	Expands or collapses a currently selected submanager.
IlvStartEditTextSelectionAccelerator	Starts editing a currently selected IlvText or IlvLabel.
IlvZoomInAccelerator	Zooms into the view.
IlvZoomOutAccelerator	Zooms out of the view.
IlvFitToSizeAccelerator	Zooms to show the whole diagram in the view.
IlvIdentityAccelerator	Reets the zoom to normal.
IlvRotateAccelerator	Rotates the view.
IlvScrollDownAccelerator	Scrolls the view down.
IlvScrollUpAccelerator	Scrolls the view up.
IlvScrollLeftAccelerator	Scrolls the view from right to left.
IlvScrollRightAccelerator	Scrolls the view from left to right.