IlvChartInteractorDispatcher Class Reference

Handles event dispatching to a set of chart interactors. More...

#include <ilviews/charts/chartint.h>

Inheritance diagram for IlvChartInteractorDispatcher:

List of all members.

Public Member Functions
	IlvChartInteractorDispatcher ()
	Constructor.
virtual void	abort (IlvGraphic *)
	Aborts event dispatching.
virtual IlBoolean	handleEvent (IlvGraphic *chart, IlvEvent &ev, const IlvTransformer *t=0)
	Dispatches the event to the appropriate interactor.

---

Detailed Description

Handles event dispatching to a set of chart interactors.

Library: ilvcharts

This class implements the event dispatching mechanism between several chart interactors. Each interactive chart object is associated with an IlvChartInteractorManager instance that stores a list of chart interactors. This model lets you define exactly the set of behaviors you want to associate with a chart graphic representation. The purpose of the dispatcher is to route the events received by the chart to the appropriate interactor. To do this, the event is sent sequentially to each interactor in the manager until one of them successfully handles it. When an interactor successfully handles an IlvButtonDown event, it is considered as the active interactor until an IlvButtonUp event is received by the dispatcher. The active interactor takes priority over all other interactors.

Unlike all other IlvChartInteractor subclasses, instances of this class are not added to an interactor manager. Instead, such interactors are set directly on the chart object with the IlvGraphic::setInteractor(IlvInteractor*) method.

---

Constructor & Destructor Documentation

IlvChartInteractorDispatcher::IlvChartInteractorDispatcher

(

)

Constructor.

Initializes a new IlvChartInteractorDispatcher object.

---

Member Function Documentation

virtual void IlvChartInteractorDispatcher::abort

(

IlvGraphic *

)

[virtual]

Aborts event dispatching.

This method is called by the IlvChartInteractorDispatcher::handleEvent method when the escape key is pressed. The default implementation calls the abort method of the active interactor if it exists.

Parameters:

chart

The chart that currently receives events.

Reimplemented from IlvInteractor.

virtual IlBoolean IlvChartInteractorDispatcher::handleEvent	(	IlvGraphic *	chart,
		IlvEvent &	ev,
		const IlvTransformer *	t = 0
	)			[virtual]

Dispatches the event to the appropriate interactor.

Parameters:

	chart	The chart object that received the event.
	event	The received event.
	t	The transformer applied to the view in which the event occurred.

Returns:

IlTrue if the event was successfully dispatched and IlFalse otherwise.

Implements IlvChartInteractor.