rwlogo
Rogue Wave Views 5.5.1

Rogue Wave Views
Foundation Package API Reference Guide

Product Documentation:

Rogue Wave Views
Documentation Home

IlvGaugeInteractor Class Reference

Interactor class for IlvGauge objects. More...

#include <ilviews/graphics/gauge.h>

Inheritance diagram for IlvGaugeInteractor:
IlvInteractor

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

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.

© Copyright 2012, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.