IlvGaugeInteractor Class Reference

Interactor class for IlvGauge objects. More...

#include <ilviews/graphics/gauge.h>

Inheritance diagram for IlvGaugeInteractor:

List of all members.

Public Types
typedef void(*	Callback )(IlvGauge *gauge, IlFloat value, IlAny userArg)
Public Member Functions
	IlvGaugeInteractor (Callback callback=0, IlAny callbackarg=0, Callback dragCallback=0, IlAny dragCallbackarg=0)
	Constructor:.
virtual IlBoolean	accept (const IlvGraphic *) const
	Indicates whether the current interactor can be associated with a given object.
virtual void	draggedValueChanged (IlvGauge *gauge, IlFloat value)
	Action triggered when dragging the mouse over the gauge.
virtual IlBoolean	handleEvent (IlvGraphic *obj, IlvEvent &event, const IlvTransformer *t)
	Handles events received by the interactor.
virtual void	valueChanged (IlvGauge *gauge, IlFloat value)
	Action triggered when the gauge value changes.

---

Detailed Description

Interactor class for IlvGauge objects.

Library: views

Use this class to interactively change values for gauges. You can easily subtype this class, and create more application-dedicated tasks, by overloading the member functions valueChanged or draggedValueChanged to test for the values that the end-user specifies.
The registered name of this interactor is "Gauge".

See also:

IlvGauge.

---

Member Typedef Documentation

IlvGaugeInteractor::Callback

This type defines the signatures of functions that are called by the gauge interactor.

Parameters:

	gauge	The gauge object that the function applies to.
	value	The new value for the gauge object gauge.
	userArg	The user parameter.

---

Constructor & Destructor Documentation

IlvGaugeInteractor::IlvGaugeInteractor	(	Callback	callback = 0,
		IlAny	callbackarg = 0,
		Callback	dragCallback = 0,
		IlAny	dragCallbackarg = 0
	)

Constructor:.

The constructor of this interactor expects two possible pairs of a user-defined function and argument. The first, callback, is a function that is called with the callbackarg parameter when the user has set a new value to a gauge and released the gauge. The second callback, dragCallbackarg, is called each time a value is changed, allowing the application to follow the user's choices.

---

Member Function Documentation

virtual IlBoolean IlvGaugeInteractor::accept

(

const IlvGraphic *

obj

)

const [virtual]

Indicates whether the current interactor can be associated with a given object.

Parameters:

obj

The considered graphic object.

Returns:

xxIlTrue if the interactor can safely be attached to obj, and xxIlFalse otherwise.

See also:

IlvGraphic::setInteractor

Reimplemented from IlvInteractor.

virtual void IlvGaugeInteractor::draggedValueChanged	(	IlvGauge *	gauge,
		IlFloat	value
	)			[virtual]

Action triggered when dragging the mouse over the gauge.

Called when the user drags the mouse. The default implementation is to update the gauge, and call the callback function if it exists.

Parameters:

	gauge	The gauge.
	value	The new value of the gauge.

virtual IlBoolean IlvGaugeInteractor::handleEvent	(	IlvGraphic *	g,
		IlvEvent &	event,
		const IlvTransformer *	t
	)			[virtual]

Handles events received by the interactor.

This method is the entry point of all events dispatched to this interactor.

Parameters:

	g	The graphic object that receives 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 handled and IlFalse otherwise.

Implements IlvInteractor.

virtual void IlvGaugeInteractor::valueChanged	(	IlvGauge *	gauge,
		IlFloat	value
	)			[virtual]

Action triggered when the gauge value changes.

Called when the user releases the gauge being manipulated. The default implementation is to update the gauge, and call the callback function if it exists.

Parameters:

	gauge	The gauge.
	value	The new value of the gauge.