![]() |
![]() |
![]() |
libatspi Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
atspi-statesetatspi-stateset — The atspi-stateset objects implement wrappers around a bitmap of accessible states. |
struct AtspiStateSet; struct AtspiStateSetClass; AtspiStateSet * atspi_state_set_new (GArray *states
); void atspi_state_set_set_by_name (AtspiStateSet *set
,const gchar *name
,gboolean enabled
); void atspi_state_set_add (AtspiStateSet *set
,AtspiStateType state
); AtspiStateSet * atspi_state_set_compare (AtspiStateSet *set
,AtspiStateSet *set2
); gboolean atspi_state_set_contains (AtspiStateSet *set
,AtspiStateType state
); gboolean atspi_state_set_equals (AtspiStateSet *set
,AtspiStateSet *set2
); GArray * atspi_state_set_get_states (AtspiStateSet *set
); gboolean atspi_state_set_is_empty (AtspiStateSet *set
); void atspi_state_set_remove (AtspiStateSet *set
,AtspiStateType state
);
AtspiStateSet * atspi_state_set_new (GArray *states
);
states
: (element-type AtspiStateType): An array of states with which the
method initializes the state set.
Generates an AtspiStateSet with the given states
.
Returns : |
A new AtspiStateSet with the given states. |
void atspi_state_set_set_by_name (AtspiStateSet *set
,const gchar *name
,gboolean enabled
);
set
: a pointer to the AtspiStateSet object on which to operate.
name
: a string corresponding to a state name.
enabled
: if TRUE, name
should be enabled in the set
in question; otherwise, it
should be disabled.
Enables/disables a state in an AtspiStateSet according to its name
.
void atspi_state_set_add (AtspiStateSet *set
,AtspiStateType state
);
set
: a pointer to the AtspiStateSet object on which to operate.
state
: an AtspiStateType to be added to the specified AtspiStateSet.
Adds a particular AtspiState to an AtspiStateSet (i.e. sets the given state to TRUE in the stateset).
AtspiStateSet * atspi_state_set_compare (AtspiStateSet *set
,AtspiStateSet *set2
);
set
: a pointer to the first AtspiStateSet object on which to operate.
set2
: a pointer to the second AtspiStateSet object on which to operate.
Determines the differences between two instances of AtspiStateSet.
Returns : |
an AtspiStateSet object containing all states contained on one of the two sets but not the other. [transfer full] |
gboolean atspi_state_set_contains (AtspiStateSet *set
,AtspiStateType state
);
set
: a pointer to the AtspiStateSet object on which to operate.
state
: an AtspiStateType for which the specified AtspiStateSet
will be queried.
Determines whether a given AtspiStateSet includes a given state; that is,
whether state
is true for the set
in question.
Returns : |
TRUE if state is true/included in the given AtspiStateSet,
otherwise FALSE. |
gboolean atspi_state_set_equals (AtspiStateSet *set
,AtspiStateSet *set2
);
set
: a pointer to the first AtspiStateSet object on which to operate.
set2
: a pointer to the second AtspiStateSet object on which to operate.
Determines whether two instances of AtspiStateSet are equivalent (i.e. consist of the same AtspiStates). Useful for checking multiple state variables at once.
Returns : |
TRUE if the two AtspiStateSets are equivalent, otherwise FALSE. |
GArray * atspi_state_set_get_states (AtspiStateSet *set
);
set
: The AtspiStateSet to be queried.
Returns the states in an AtspiStateSet as an array.
Returns : |
A GArray of state types representing the current state. [element-type AtspiStateType][transfer full] |
gboolean atspi_state_set_is_empty (AtspiStateSet *set
);
set
: The AtspiStateSet to query.
Returns : |
TRUE if the state set contains no states; FALSE otherwise. |
void atspi_state_set_remove (AtspiStateSet *set
,AtspiStateType state
);
set
: a pointer to the AtspiStateSet object on which to operate.
state
: an AtspiStateType to remove from the specified set
.
Removes a particular AtspiState to an AtspiStateSet (i.e. sets the given state to FALSE in the stateset.)