AtkValue

AtkValue — The ATK interface implemented by valuators and components which display or select a value from a bounded range of values.

Synopsis




            AtkValue;
void        atk_value_get_current_value     (AtkValue *obj,
                                             GValue *value);
void        atk_value_get_maximum_value     (AtkValue *obj,
                                             GValue *value);
void        atk_value_get_minimum_value     (AtkValue *obj,
                                             GValue *value);
gboolean    atk_value_set_current_value     (AtkValue *obj,
                                             const GValue *value);
void        atk_value_get_minimum_increment (AtkValue *obj,
                                             GValue *value);

Object Hierarchy


  GInterface
   +----AtkValue

Known Implementations

AtkValue is implemented by AtkNoOpObject.

Description

AtkValue should be implemented for components which either display a value from a bounded range, or which allow the user to specify a value from a bounded range, or both. For instance, most sliders and range controls, as well as dials, should have AtkObject representations which implement AtkValue on the component's behalf. AtKValues may be read-only, in which case attempts to alter the value return FALSE to indicate failure.

Details

AtkValue

typedef struct _AtkValue AtkValue;

The AtkValue structure does not contain any fields.

atk_value_get_current_value ()

void        atk_value_get_current_value     (AtkValue *obj,
                                             GValue *value);

Gets the value of this object.

obj : a GObject instance that implements AtkValueIface
value : a GValue representing the current accessible value

atk_value_get_maximum_value ()

void        atk_value_get_maximum_value     (AtkValue *obj,
                                             GValue *value);

Gets the maximum value of this object.

obj : a GObject instance that implements AtkValueIface
value : a GValue representing the maximum accessible value

atk_value_get_minimum_value ()

void        atk_value_get_minimum_value     (AtkValue *obj,
                                             GValue *value);

Gets the minimum value of this object.

obj : a GObject instance that implements AtkValueIface
value : a GValue representing the minimum accessible value

atk_value_set_current_value ()

gboolean    atk_value_set_current_value     (AtkValue *obj,
                                             const GValue *value);

Sets the value of this object.

obj : a GObject instance that implements AtkValueIface
value : a GValue which is the desired new accessible value.
Returns : TRUE if new value is successfully set, FALSE otherwise.

atk_value_get_minimum_increment ()

void        atk_value_get_minimum_increment (AtkValue *obj,
                                             GValue *value);

Gets the minimum increment by which the value of this object may be changed. If zero, the minimum increment is undefined, which may mean that it is limited only by the floating point precision of the platform.

obj : a GObject instance that implements AtkValueIface
value : a GValue representing the minimum increment by which the accessible value may be changed

Since ATK 1.12