31
31
<a href="#at-spi-cspi-State-and-StateSets.description" class="shortcut">Description</a>
34
<div class="refentry" title="State and StateSets">
34
<div class="refentry" lang="en">
35
35
<a name="at-spi-cspi-State-and-StateSets"></a><div class="titlepage"></div>
36
36
<div class="refnamediv"><table width="100%"><tr>
38
38
<h2><span class="refentrytitle"><a name="at-spi-cspi-State-and-StateSets.top_of_page"></a>State and StateSets</span></h2>
39
<p>State and StateSets</p>
39
<p>State and StateSets — </p>
41
41
<td valign="top" align="right"></td>
42
42
</tr></table></div>
43
<div class="refsynopsisdiv" title="Synopsis">
43
<div class="refsynopsisdiv">
44
44
<a name="at-spi-cspi-State-and-StateSets.synopsis"></a><h2>Synopsis</h2>
45
45
<pre class="synopsis">
46
enum <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a>;
47
struct <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a>;
48
void <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-ref" title="AccessibleStateSet_ref ()">AccessibleStateSet_ref</a> (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);
49
void <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-unref" title="AccessibleStateSet_unref ()">AccessibleStateSet_unref</a> (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);
50
void <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-add" title="AccessibleStateSet_add ()">AccessibleStateSet_add</a> (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
51
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a> state);
52
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> * <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-compare" title="AccessibleStateSet_compare ()">AccessibleStateSet_compare</a> (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
53
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj2);
54
SPIBoolean <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-contains" title="AccessibleStateSet_contains ()">AccessibleStateSet_contains</a> (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
55
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a> state);
56
SPIBoolean <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-equals" title="AccessibleStateSet_equals ()">AccessibleStateSet_equals</a> (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
57
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj2);
58
SPIBoolean <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-isEmpty" title="AccessibleStateSet_isEmpty ()">AccessibleStateSet_isEmpty</a> (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);
59
void <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-remove" title="AccessibleStateSet_remove ()">AccessibleStateSet_remove</a> (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
60
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a> state);
46
enum <a href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a>;
47
struct <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a>;
48
void <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-ref" title="AccessibleStateSet_ref ()">AccessibleStateSet_ref</a> (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);
49
void <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-unref" title="AccessibleStateSet_unref ()">AccessibleStateSet_unref</a> (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);
50
void <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-add" title="AccessibleStateSet_add ()">AccessibleStateSet_add</a> (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
51
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a> state);
52
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> * <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-compare" title="AccessibleStateSet_compare ()">AccessibleStateSet_compare</a> (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
53
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj2);
54
SPIBoolean <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-contains" title="AccessibleStateSet_contains ()">AccessibleStateSet_contains</a> (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
55
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a> state);
56
SPIBoolean <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-equals" title="AccessibleStateSet_equals ()">AccessibleStateSet_equals</a> (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
57
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj2);
58
SPIBoolean <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-isEmpty" title="AccessibleStateSet_isEmpty ()">AccessibleStateSet_isEmpty</a> (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);
59
void <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-remove" title="AccessibleStateSet_remove ()">AccessibleStateSet_remove</a> (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
60
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a> state);
63
<div class="refsect1" title="Description">
63
<div class="refsect1" lang="en">
64
64
<a name="at-spi-cspi-State-and-StateSets.description"></a><h2>Description</h2>
68
<div class="refsect1" title="Details">
68
<div class="refsect1" lang="en">
69
69
<a name="at-spi-cspi-State-and-StateSets.details"></a><h2>Details</h2>
70
<div class="refsect2" title="enum AccessibleState">
70
<div class="refsect2" lang="en">
71
71
<a name="AccessibleState"></a><h3>enum AccessibleState</h3>
72
72
<pre class="programlisting">typedef enum
121
121
<col align="left" valign="top">
124
<td><p><a name="SPI-STATE-INVALID--CAPS"></a><span class="term"><code class="literal">SPI_STATE_INVALID</code></span></p></td>
125
<a name="SPI-STATE-INVALID--CAPS"></a><span class="term"><code class="literal">SPI_STATE_INVALID</code></span></td>
125
126
<td> Indicates an invalid state
129
<td><p><a name="SPI-STATE-ACTIVE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_ACTIVE</code></span></p></td>
131
<a name="SPI-STATE-ACTIVE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_ACTIVE</code></span></td>
130
132
<td> Indicates a window is currently the active window
134
<td><p><a name="SPI-STATE-ARMED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_ARMED</code></span></p></td>
137
<a name="SPI-STATE-ARMED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_ARMED</code></span></td>
135
138
<td> Indicates that the object is armed
139
<td><p><a name="SPI-STATE-BUSY--CAPS"></a><span class="term"><code class="literal">SPI_STATE_BUSY</code></span></p></td>
143
<a name="SPI-STATE-BUSY--CAPS"></a><span class="term"><code class="literal">SPI_STATE_BUSY</code></span></td>
140
144
<td> Indicates the current object is busy
144
<td><p><a name="SPI-STATE-CHECKED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_CHECKED</code></span></p></td>
149
<a name="SPI-STATE-CHECKED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_CHECKED</code></span></td>
145
150
<td> Indicates this object is currently checked
149
<td><p><a name="SPI-STATE-COLLAPSED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_COLLAPSED</code></span></p></td>
155
<a name="SPI-STATE-COLLAPSED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_COLLAPSED</code></span></td>
150
156
<td> Indicates this object is collapsed
154
<td><p><a name="SPI-STATE-DEFUNCT--CAPS"></a><span class="term"><code class="literal">SPI_STATE_DEFUNCT</code></span></p></td>
161
<a name="SPI-STATE-DEFUNCT--CAPS"></a><span class="term"><code class="literal">SPI_STATE_DEFUNCT</code></span></td>
155
162
<td> Indicates the user interface object corresponding to this object no longer exists
159
<td><p><a name="SPI-STATE-EDITABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_EDITABLE</code></span></p></td>
167
<a name="SPI-STATE-EDITABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_EDITABLE</code></span></td>
160
168
<td> Indicates the user can change the contents of this object
164
<td><p><a name="SPI-STATE-ENABLED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_ENABLED</code></span></p></td>
173
<a name="SPI-STATE-ENABLED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_ENABLED</code></span></td>
165
174
<td> Indicates that this object is enabled
169
<td><p><a name="SPI-STATE-EXPANDABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_EXPANDABLE</code></span></p></td>
179
<a name="SPI-STATE-EXPANDABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_EXPANDABLE</code></span></td>
170
180
<td> Indicates this object allows progressive disclosure of its children
174
<td><p><a name="SPI-STATE-EXPANDED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_EXPANDED</code></span></p></td>
185
<a name="SPI-STATE-EXPANDED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_EXPANDED</code></span></td>
175
186
<td> Indicates this object its expanded
179
<td><p><a name="SPI-STATE-FOCUSABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_FOCUSABLE</code></span></p></td>
191
<a name="SPI-STATE-FOCUSABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_FOCUSABLE</code></span></td>
180
192
<td> 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
184
<td><p><a name="SPI-STATE-FOCUSED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_FOCUSED</code></span></p></td>
197
<a name="SPI-STATE-FOCUSED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_FOCUSED</code></span></td>
185
198
<td> Indicates this object currently has the keyboard focus
189
<td><p><a name="SPI-STATE-HORIZONTAL--CAPS"></a><span class="term"><code class="literal">SPI_STATE_HORIZONTAL</code></span></p></td>
203
<a name="SPI-STATE-HORIZONTAL--CAPS"></a><span class="term"><code class="literal">SPI_STATE_HORIZONTAL</code></span></td>
190
204
<td> Indicates the orientation of thsi object is horizontal
194
<td><p><a name="SPI-STATE-ICONIFIED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_ICONIFIED</code></span></p></td>
209
<a name="SPI-STATE-ICONIFIED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_ICONIFIED</code></span></td>
195
210
<td> Indicates this object is minimized and is represented only by an icon
199
<td><p><a name="SPI-STATE-MODAL--CAPS"></a><span class="term"><code class="literal">SPI_STATE_MODAL</code></span></p></td>
215
<a name="SPI-STATE-MODAL--CAPS"></a><span class="term"><code class="literal">SPI_STATE_MODAL</code></span></td>
200
216
<td> Indicates something must be done with this object before the user can interact with an object in a different window
204
<td><p><a name="SPI-STATE-MULTI-LINE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_MULTI_LINE</code></span></p></td>
221
<a name="SPI-STATE-MULTI-LINE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_MULTI_LINE</code></span></td>
205
222
<td> Indicates this (text) object can contain multiple lines of text
209
<td><p><a name="SPI-STATE-MULTISELECTABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_MULTISELECTABLE</code></span></p></td>
227
<a name="SPI-STATE-MULTISELECTABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_MULTISELECTABLE</code></span></td>
210
228
<td> Indicates this object allows more than one of its children to be selected at the same time
214
<td><p><a name="SPI-STATE-OPAQUE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_OPAQUE</code></span></p></td>
233
<a name="SPI-STATE-OPAQUE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_OPAQUE</code></span></td>
215
234
<td> Indicates this object paints every pixel within its rectangular region
219
<td><p><a name="SPI-STATE-PRESSED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_PRESSED</code></span></p></td>
239
<a name="SPI-STATE-PRESSED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_PRESSED</code></span></td>
220
240
<td> Indicates this object is currently pressed
224
<td><p><a name="SPI-STATE-RESIZABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_RESIZABLE</code></span></p></td>
245
<a name="SPI-STATE-RESIZABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_RESIZABLE</code></span></td>
225
246
<td> Indicates the size of this object is not fixed
229
<td><p><a name="SPI-STATE-SELECTABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTABLE</code></span></p></td>
251
<a name="SPI-STATE-SELECTABLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTABLE</code></span></td>
230
252
<td> 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
234
<td><p><a name="SPI-STATE-SELECTED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTED</code></span></p></td>
257
<a name="SPI-STATE-SELECTED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTED</code></span></td>
235
258
<td> 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
239
<td><p><a name="SPI-STATE-SENSITIVE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SENSITIVE</code></span></p></td>
263
<a name="SPI-STATE-SENSITIVE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SENSITIVE</code></span></td>
240
264
<td> Indicates this object is sensitive
244
<td><p><a name="SPI-STATE-SHOWING--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SHOWING</code></span></p></td>
269
<a name="SPI-STATE-SHOWING--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SHOWING</code></span></td>
245
270
<td> Indicates this object, the object's parent, the object's parent's parent, and so on, are all visible
249
<td><p><a name="SPI-STATE-SINGLE-LINE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SINGLE_LINE</code></span></p></td>
275
<a name="SPI-STATE-SINGLE-LINE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SINGLE_LINE</code></span></td>
250
276
<td> Indicates this (text) object can contain only a single line of text
254
<td><p><a name="SPI-STATE-STALE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_STALE</code></span></p></td>
281
<a name="SPI-STATE-STALE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_STALE</code></span></td>
255
282
<td> Indicates that the index associated with this object has changed since the user accessed the object
259
<td><p><a name="SPI-STATE-TRANSIENT--CAPS"></a><span class="term"><code class="literal">SPI_STATE_TRANSIENT</code></span></p></td>
287
<a name="SPI-STATE-TRANSIENT--CAPS"></a><span class="term"><code class="literal">SPI_STATE_TRANSIENT</code></span></td>
260
288
<td> Indicates this object is transient
264
<td><p><a name="SPI-STATE-VERTICAL--CAPS"></a><span class="term"><code class="literal">SPI_STATE_VERTICAL</code></span></p></td>
293
<a name="SPI-STATE-VERTICAL--CAPS"></a><span class="term"><code class="literal">SPI_STATE_VERTICAL</code></span></td>
265
294
<td> Indicates the orientation of this object is vertical
269
<td><p><a name="SPI-STATE-VISIBLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_VISIBLE</code></span></p></td>
299
<a name="SPI-STATE-VISIBLE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_VISIBLE</code></span></td>
270
300
<td> Indicates this object is visible
274
<td><p><a name="SPI-STATE-MANAGES-DESCENDANTS--CAPS"></a><span class="term"><code class="literal">SPI_STATE_MANAGES_DESCENDANTS</code></span></p></td>
305
<a name="SPI-STATE-MANAGES-DESCENDANTS--CAPS"></a><span class="term"><code class="literal">SPI_STATE_MANAGES_DESCENDANTS</code></span></td>
275
306
<td> Indicates that "active-descendant-changed"
276
307
event is sent when children become 'active' (i.e. are selected or navigated
277
308
to onscreen). Used to prevent need to enumerate all children in very large
282
<td><p><a name="SPI-STATE-INDETERMINATE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_INDETERMINATE</code></span></p></td>
314
<a name="SPI-STATE-INDETERMINATE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_INDETERMINATE</code></span></td>
283
315
<td> Indicates that a check box is in a state other than checked or not checked.
287
<td><p><a name="SPI-STATE-TRUNCATED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_TRUNCATED</code></span></p></td>
320
<a name="SPI-STATE-TRUNCATED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_TRUNCATED</code></span></td>
288
321
<td> Indicates that an object is truncated, e.g. a text value in a speradsheet cell.
292
<td><p><a name="SPI-STATE-REQUIRED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_REQUIRED</code></span></p></td>
326
<a name="SPI-STATE-REQUIRED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_REQUIRED</code></span></td>
293
327
<td> Indicates that explicit user interaction with an object is required by the user interface, e.g. a required field in a "web-form" interface.
297
<td><p><a name="SPI-STATE-INVALID-ENTRY--CAPS"></a><span class="term"><code class="literal">SPI_STATE_INVALID_ENTRY</code></span></p></td>
332
<a name="SPI-STATE-INVALID-ENTRY--CAPS"></a><span class="term"><code class="literal">SPI_STATE_INVALID_ENTRY</code></span></td>
298
333
<td> 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.
302
<td><p><a name="SPI-STATE-SUPPORTS-AUTOCOMPLETION--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SUPPORTS_AUTOCOMPLETION</code></span></p></td>
338
<a name="SPI-STATE-SUPPORTS-AUTOCOMPLETION--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SUPPORTS_AUTOCOMPLETION</code></span></td>
303
339
<td> 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 <em class="parameter"><code>SPI_ROLE_AUTOCOMPLETE</code></em>.
307
<td><p><a name="SPI-STATE-SELECTABLE-TEXT--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTABLE_TEXT</code></span></p></td>
344
<a name="SPI-STATE-SELECTABLE-TEXT--CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTABLE_TEXT</code></span></td>
308
345
<td>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 <em class="parameter"><code>SPI_STATE_SELECTABLE</code></em>, 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.
312
<td><p><a name="SPI-STATE-IS-DEFAULT--CAPS"></a><span class="term"><code class="literal">SPI_STATE_IS_DEFAULT</code></span></p></td>
350
<a name="SPI-STATE-IS-DEFAULT--CAPS"></a><span class="term"><code class="literal">SPI_STATE_IS_DEFAULT</code></span></td>
313
351
<td> 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.
317
<td><p><a name="SPI-STATE-VISITED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_VISITED</code></span></p></td>
356
<a name="SPI-STATE-VISITED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_VISITED</code></span></td>
318
357
<td> Indicates that the object (typically a hyperlink) has already been 'activated', and/or its backing data has already been downloaded, rendered, or otherwise "visited".
322
<td><p><a name="SPI-STATE-LAST-DEFINED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_LAST_DEFINED</code></span></p></td>
362
<a name="SPI-STATE-LAST-DEFINED--CAPS"></a><span class="term"><code class="literal">SPI_STATE_LAST_DEFINED</code></span></td>
323
363
<td> Not a valid state, used for finding end of enumeration
365
<div class="refsect2" title="AccessibleStateSet_ref ()">
407
<div class="refsect2" lang="en">
366
408
<a name="AccessibleStateSet-ref"></a><h3>AccessibleStateSet_ref ()</h3>
367
<pre class="programlisting">void AccessibleStateSet_ref (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);</pre>
409
<pre class="programlisting">void AccessibleStateSet_ref (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);</pre>
369
Increment the reference count for an <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object.</p>
411
Increment the reference count for an <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object.</p>
372
414
<div class="variablelist"><table border="0">
373
415
<col align="left" valign="top">
375
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
376
<td> a pointer to the <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
418
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
419
<td> a pointer to the <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
382
<div class="refsect2" title="AccessibleStateSet_unref ()">
425
<div class="refsect2" lang="en">
383
426
<a name="AccessibleStateSet-unref"></a><h3>AccessibleStateSet_unref ()</h3>
384
<pre class="programlisting">void AccessibleStateSet_unref (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);</pre>
427
<pre class="programlisting">void AccessibleStateSet_unref (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);</pre>
386
Decrement the reference count for an <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object.</p>
429
Decrement the reference count for an <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object.</p>
389
432
<div class="variablelist"><table border="0">
390
433
<col align="left" valign="top">
392
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
393
<td> a pointer to the <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
436
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
437
<td> a pointer to the <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
399
<div class="refsect2" title="AccessibleStateSet_add ()">
443
<div class="refsect2" lang="en">
400
444
<a name="AccessibleStateSet-add"></a><h3>AccessibleStateSet_add ()</h3>
401
<pre class="programlisting">void AccessibleStateSet_add (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
402
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a> state);</pre>
445
<pre class="programlisting">void AccessibleStateSet_add (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
446
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a> state);</pre>
404
Add a particular <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> to an <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> (i.e. set the
448
Add a particular <a href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> to an <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> (i.e. set the
405
449
given state to <a
406
450
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
407
451
><span class="type">TRUE</span></a> in the stateset.</p>
411
455
<col align="left" valign="top">
414
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
415
<td> a pointer to the <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
459
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
460
<td> a pointer to the <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
419
<td><p><span class="term"><em class="parameter"><code>state</code></em> :</span></p></td>
420
<td> an <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> to be added to the specified <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a>
465
<span class="term"><em class="parameter"><code>state</code></em> :</span></td>
466
<td> an <a href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> to be added to the specified <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a>
427
<div class="refsect2" title="AccessibleStateSet_compare ()">
473
<div class="refsect2" lang="en">
428
474
<a name="AccessibleStateSet-compare"></a><h3>AccessibleStateSet_compare ()</h3>
429
<pre class="programlisting"><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> * AccessibleStateSet_compare (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
430
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj2);</pre>
475
<pre class="programlisting"><a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> * AccessibleStateSet_compare (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
476
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj2);</pre>
432
Determine the differences between two instances of <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a>.
478
Determine the differences between two instances of <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a>.
433
479
Not Yet Implemented.
435
<em class="parameter"><code>see</code></em> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-equals" title="AccessibleStateSet_equals ()"><code class="function">AccessibleStateSet_equals()</code></a>.</p>
481
<em class="parameter"><code>see</code></em> <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-equals" title="AccessibleStateSet_equals ()"><code class="function">AccessibleStateSet_equals()</code></a>.</p>
438
484
<div class="variablelist"><table border="0">
439
485
<col align="left" valign="top">
442
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
443
<td> a pointer to the first <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
447
<td><p><span class="term"><em class="parameter"><code>obj2</code></em> :</span></p></td>
448
<td> a pointer to the second <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
452
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
453
<td> an <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object containing all states contained on one of
489
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
490
<td> a pointer to the first <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
495
<span class="term"><em class="parameter"><code>obj2</code></em> :</span></td>
496
<td> a pointer to the second <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
501
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
502
<td> an <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object containing all states contained on one of
454
503
the two sets but not the other.
472
521
<col align="left" valign="top">
475
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
476
<td> a pointer to the <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
525
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
526
<td> a pointer to the <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
480
<td><p><span class="term"><em class="parameter"><code>state</code></em> :</span></p></td>
481
<td> an <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> for which the specified <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a>
531
<span class="term"><em class="parameter"><code>state</code></em> :</span></td>
532
<td> an <a href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> for which the specified <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a>
486
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
538
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
488
540
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
489
><span class="type">TRUE</span></a> if <em class="parameter"><code>state</code></em> is true/included in the given <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a>,
541
><span class="type">TRUE</span></a> if <em class="parameter"><code>state</code></em> is true/included in the given <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a>,
491
543
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
492
544
><span class="type">FALSE</span></a>.
500
<div class="refsect2" title="AccessibleStateSet_equals ()">
552
<div class="refsect2" lang="en">
501
553
<a name="AccessibleStateSet-equals"></a><h3>AccessibleStateSet_equals ()</h3>
502
<pre class="programlisting">SPIBoolean AccessibleStateSet_equals (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
503
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj2);</pre>
554
<pre class="programlisting">SPIBoolean AccessibleStateSet_equals (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj,
555
<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj2);</pre>
505
Determine whether two instances of <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> are equivalent (i.e.
557
Determine whether two instances of <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> are equivalent (i.e.
506
558
consist of the same <span class="type">AccessibleStates</span>). Useful for checking multiple
507
559
state variables at once; construct the target state then compare against it.
510
<em class="parameter"><code>see</code></em> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-compare" title="AccessibleStateSet_compare ()"><code class="function">AccessibleStateSet_compare()</code></a>.</p>
562
<em class="parameter"><code>see</code></em> <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-compare" title="AccessibleStateSet_compare ()"><code class="function">AccessibleStateSet_compare()</code></a>.</p>
513
565
<div class="variablelist"><table border="0">
514
566
<col align="left" valign="top">
517
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
518
<td> a pointer to the first <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
522
<td><p><span class="term"><em class="parameter"><code>obj2</code></em> :</span></p></td>
523
<td> a pointer to the second <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
527
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
570
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
571
<td> a pointer to the first <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
576
<span class="term"><em class="parameter"><code>obj2</code></em> :</span></td>
577
<td> a pointer to the second <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
582
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
529
584
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
530
585
><span class="type">TRUE</span></a> if the two <span class="type">AccessibleStateSets</span> are equivalent,
541
<div class="refsect2" title="AccessibleStateSet_isEmpty ()">
596
<div class="refsect2" lang="en">
542
597
<a name="AccessibleStateSet-isEmpty"></a><h3>AccessibleStateSet_isEmpty ()</h3>
543
<pre class="programlisting">SPIBoolean AccessibleStateSet_isEmpty (<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);</pre>
598
<pre class="programlisting">SPIBoolean AccessibleStateSet_isEmpty (<a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet">AccessibleStateSet</a> *obj);</pre>
545
Determine whether a given <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> is the empty set.</p>
600
Determine whether a given <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> is the empty set.</p>
548
603
<div class="variablelist"><table border="0">
549
604
<col align="left" valign="top">
552
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
553
<td> a pointer to the <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
608
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
609
<td> a pointer to the <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> object on which to operate.
557
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
614
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
559
616
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
560
><span class="type">TRUE</span></a> if the given <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> contains no (true) states,
617
><span class="type">TRUE</span></a> if the given <a href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> contains no (true) states,
562
619
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
563
620
><span class="type">FALSE</span></a>.