AccessibleValue Interface

AccessibleValue Interface — An interface implemented by valuators, sliders, and other onscren components which allow discrete or continuous values to be manipulated.

Functions

Description

The Value interface is exposed by sliders, scrollbars, dials, and other components which are used to change scalar values in an application. The interface may be used to change a value in an "approximately continuous" fashion, or in integer increments - the interface allows the client to determine the incremental granularity of the adjustments possible, the possible range of values, and the current value. It also allows the value to be programmatically set, if the implementor's state does not include READONLY.

Functions

AccessibleValue_ref ()

void
AccessibleValue_ref (AccessibleValue *obj);

Increment the reference count for an AccessibleValue object.

Parameters

obj

a pointer to the AccessibleValue implementor on which to operate.

 

AccessibleValue_unref ()

void
AccessibleValue_unref (AccessibleValue *obj);

Decrement the reference count for an AccessibleValue object.

Parameters

obj

a pointer to the AccessibleValue implementor on which to operate.

 

AccessibleValue_getCurrentValue ()

double
AccessibleValue_getCurrentValue (AccessibleValue *obj);

Get the current value for an AccessibleValue.

Parameters

obj

a pointer to the AccessibleValue implementor on which to operate.

 

Returns

the current value for this object.


AccessibleValue_getMaximumValue ()

double
AccessibleValue_getMaximumValue (AccessibleValue *obj);

Get the maximum allowed value for an AccessibleValue.

Parameters

obj

a pointer to the AccessibleValue implementor on which to operate.

 

Returns

the maximum allowed value for this object.


AccessibleValue_getMinimumValue ()

double
AccessibleValue_getMinimumValue (AccessibleValue *obj);

Get the minimum allowed value for an AccessibleValue.

Parameters

obj

a pointer to the AccessibleValue implementor on which to operate.

 

Returns

the minimum allowed value for this object.


AccessibleValue_setCurrentValue ()

SPIBoolean
AccessibleValue_setCurrentValue (AccessibleValue *obj,
                                 double newValue);

Set the current value of an AccessibleValue.

Parameters

obj

a pointer to the AccessibleValue implementor on which to operate.

 

newValue

a float value which is the desired new value of the object.

 

Returns

TRUE if the value could be assigned the specified value, FALSE otherwise.


AccessibleValue_getMinimumIncrement ()

double
AccessibleValue_getMinimumIncrement (AccessibleValue *obj);

Get the minimum increment by which an AccessibleValue can be adjusted.

Parameters

obj

a pointer to the AccessibleValue implementor on which to operate.

 

Returns

the minimum increment by which the value may be changed, or zero if the minimum increment cannot be determined.

Types and Values