State and StateSets

State and StateSets

Functions

Types and Values

Description

Functions

AccessibleStateSet_ref ()

void
AccessibleStateSet_ref (AccessibleStateSet *obj);

Increment the reference count for an AccessibleStateSet object.

Parameters

obj

a pointer to the AccessibleStateSet object on which to operate.

 

AccessibleStateSet_unref ()

void
AccessibleStateSet_unref (AccessibleStateSet *obj);

Decrement the reference count for an AccessibleStateSet object.

Parameters

obj

a pointer to the AccessibleStateSet object on which to operate.

 

AccessibleStateSet_add ()

void
AccessibleStateSet_add (AccessibleStateSet *obj,
                        AccessibleState state);

Add a particular AccessibleState to an AccessibleStateSet (i.e. set the given state to TRUE in the stateset.

Parameters

obj

a pointer to the AccessibleStateSet object on which to operate.

 

state

an AccessibleState to be added to the specified AccessibleStateSet

 

AccessibleStateSet_compare ()

AccessibleStateSet *
AccessibleStateSet_compare (AccessibleStateSet *obj,
                            AccessibleStateSet *obj2);

Determine the differences between two instances of AccessibleStateSet. Not Yet Implemented. . see AccessibleStateSet_equals().

Parameters

obj

a pointer to the first AccessibleStateSet object on which to operate.

 

obj2

a pointer to the second AccessibleStateSet object on which to operate.

 

Returns

an AccessibleStateSet object containing all states contained on one of the two sets but not the other.


AccessibleStateSet_contains ()

SPIBoolean
AccessibleStateSet_contains (AccessibleStateSet *obj,
                             AccessibleState state);

Determine whether a given AccessibleStateSet includes a given state; that is, whether state is true for the stateset in question.

Parameters

obj

a pointer to the AccessibleStateSet object on which to operate.

 

state

an AccessibleState for which the specified AccessibleStateSet will be queried.

 

Returns

TRUE if state is true/included in the given AccessibleStateSet, otherwise FALSE.


AccessibleStateSet_equals ()

SPIBoolean
AccessibleStateSet_equals (AccessibleStateSet *obj,
                           AccessibleStateSet *obj2);

Determine whether two instances of AccessibleStateSet are equivalent (i.e. consist of the same AccessibleStates). Useful for checking multiple state variables at once; construct the target state then compare against it.

see AccessibleStateSet_compare().

Parameters

obj

a pointer to the first AccessibleStateSet object on which to operate.

 

obj2

a pointer to the second AccessibleStateSet object on which to operate.

 

Returns

TRUE if the two AccessibleStateSets are equivalent, otherwise FALSE.


AccessibleStateSet_isEmpty ()

SPIBoolean
AccessibleStateSet_isEmpty (AccessibleStateSet *obj);

Determine whether a given AccessibleStateSet is the empty set.

Parameters

obj

a pointer to the AccessibleStateSet object on which to operate.

 

Returns

TRUE if the given AccessibleStateSet contains no (true) states, otherwise FALSE.


AccessibleStateSet_remove ()

void
AccessibleStateSet_remove (AccessibleStateSet *obj,
                           AccessibleState state);

Remove a particular AccessibleState to an AccessibleStateSet (i.e. set the given state to FALSE in the stateset.)

Parameters

obj

a pointer to the AccessibleStateSet object on which to operate.

 

state

an AccessibleState to be removed from the specified AccessibleStateSet

 

Types and Values

enum AccessibleState

The possibles states of an object.

Members

SPI_STATE_INVALID

Indicates an invalid state

 

SPI_STATE_ACTIVE

Indicates a window is currently the active window

 

SPI_STATE_ARMED

Indicates that the object is armed

 

SPI_STATE_BUSY

Indicates the current object is busy

 

SPI_STATE_CHECKED

Indicates this object is currently checked

 

SPI_STATE_COLLAPSED

Indicates this object is collapsed

 

SPI_STATE_DEFUNCT

Indicates the user interface object corresponding to this object no longer exists

 

SPI_STATE_EDITABLE

Indicates the user can change the contents of this object

 

SPI_STATE_ENABLED

Indicates that this object is enabled

 

SPI_STATE_EXPANDABLE

Indicates this object allows progressive disclosure of its children

 

SPI_STATE_EXPANDED

Indicates this object its expanded

 

SPI_STATE_FOCUSABLE

Indicates this object can accept keyboard focus, which means all events resulting from typing on the keyboard will normally be passed to it when it has focus

 

SPI_STATE_FOCUSED

Indicates this object currently has the keyboard focus

 

SPI_STATE_HORIZONTAL

Indicates the orientation of thsi object is horizontal

 

SPI_STATE_ICONIFIED

Indicates this object is minimized and is represented only by an icon

 

SPI_STATE_MODAL

Indicates something must be done with this object before the user can interact with an object in a different window

 

SPI_STATE_MULTI_LINE

Indicates this (text) object can contain multiple lines of text

 

SPI_STATE_MULTISELECTABLE

Indicates this object allows more than one of its children to be selected at the same time

 

SPI_STATE_OPAQUE

Indicates this object paints every pixel within its rectangular region

 

SPI_STATE_PRESSED

Indicates this object is currently pressed

 

SPI_STATE_RESIZABLE

Indicates the size of this object is not fixed

 

SPI_STATE_SELECTABLE

Indicates this object is the child of an object that allows its children to be selected and that this child is one of those children that can be selected

 

SPI_STATE_SELECTED

Indicates this object is the child of an object that allows its children to be selected and that this child is one of those children that has been selected

 

SPI_STATE_SENSITIVE

Indicates this object is sensitive

 

SPI_STATE_SHOWING

Indicates this object, the object's parent, the object's parent's parent, and so on, are all visible

 

SPI_STATE_SINGLE_LINE

Indicates this (text) object can contain only a single line of text

 

SPI_STATE_STALE

Indicates that the index associated with this object has changed since the user accessed the object

 

SPI_STATE_TRANSIENT

Indicates this object is transient

 

SPI_STATE_VERTICAL

Indicates the orientation of this object is vertical

 

SPI_STATE_VISIBLE

Indicates this object is visible

 

SPI_STATE_MANAGES_DESCENDANTS

Indicates that "active-descendant-changed" event is sent when children become 'active' (i.e. are selected or navigated to onscreen). Used to prevent need to enumerate all children in very large containers, like tables.

 

SPI_STATE_INDETERMINATE

Indicates that a check box is in a state other than checked or not checked.

 

SPI_STATE_TRUNCATED

Indicates that an object is truncated, e.g. a text value in a speradsheet cell.

 

SPI_STATE_REQUIRED

Indicates that explicit user interaction with an object is required by the user interface, e.g. a required field in a "web-form" interface.

 

SPI_STATE_INVALID_ENTRY

Indicates that the object has encountered an error condition due to failure of input validation. For instance, a form control may acquire this state in response to invalid or malformed user input.

 

SPI_STATE_SUPPORTS_AUTOCOMPLETION

Indicates that the object may exhibit "typeahead" behavior in response to user keystrokes, e.g. one keystroke may result in the insertion of several characters into an entry, or result in the auto-selection of an item in a list. This state supplants SPI_ROLE_AUTOCOMPLETE .

 

SPI_STATE_SELECTABLE_TEXT

Indicates that the object in question supports text selection. It should only be exposed on objects which implement the Text interface, in order to distinguish this state from SPI_STATE_SELECTABLE , which infers that the object in question is a selectable child of an object which implements Selection. While similar, text selection and subelement selection are distinct operations.

 

SPI_STATE_IS_DEFAULT

Indicates that the object is the "default" active component, i.e. the object which is activated by an end-user press of the "Enter" or "Return" key. Typically a "close" or "submit" button.

 

SPI_STATE_VISITED

Indicates that the object (typically a hyperlink) has already been 'activated', and/or its backing data has already been downloaded, rendered, or otherwise "visited".

 

SPI_STATE_LAST_DEFINED

Not a valid state, used for finding end of enumeration

 

struct AccessibleStateSet

struct AccessibleStateSet {
	guint   ref_count;
	GArray *states;
};

An opaque structure representing an accessible object's state, which can then be queried via AccessibleStateSet APIs.

An AccessibleStateSet determines a component's state set. It is composed of a set of AccessibleState values.

Members

guint ref_count;

private

 

GArray *states;

private