42
37
</tr></table></div>
43
38
<div class="refsynopsisdiv" title="Synopsis">
44
39
<a name="at-spi-cspi-State-and-StateSets.synopsis"></a><h2>Synopsis</h2>
45
<pre class="synopsis">
46
enum <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a>;
40
<pre class="synopsis">enum <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState">AccessibleState</a>;
47
41
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);
42
<span class="returnvalue">void</span> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-ref" title="AccessibleStateSet_ref ()">AccessibleStateSet_ref</a> (<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj</code></em>);
43
<span class="returnvalue">void</span> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-unref" title="AccessibleStateSet_unref ()">AccessibleStateSet_unref</a> (<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj</code></em>);
44
<span class="returnvalue">void</span> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-add" title="AccessibleStateSet_add ()">AccessibleStateSet_add</a> (<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj</code></em>,
45
<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> state</code></em>);
46
<a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="returnvalue">AccessibleStateSet</span></a> * <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-compare" title="AccessibleStateSet_compare ()">AccessibleStateSet_compare</a> (<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj</code></em>,
47
<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj2</code></em>);
48
<span class="returnvalue">SPIBoolean</span> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-contains" title="AccessibleStateSet_contains ()">AccessibleStateSet_contains</a> (<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj</code></em>,
49
<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> state</code></em>);
50
<span class="returnvalue">SPIBoolean</span> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-equals" title="AccessibleStateSet_equals ()">AccessibleStateSet_equals</a> (<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj</code></em>,
51
<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj2</code></em>);
52
<span class="returnvalue">SPIBoolean</span> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-isEmpty" title="AccessibleStateSet_isEmpty ()">AccessibleStateSet_isEmpty</a> (<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj</code></em>);
53
<span class="returnvalue">void</span> <a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet-remove" title="AccessibleStateSet_remove ()">AccessibleStateSet_remove</a> (<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleStateSet" title="struct AccessibleStateSet"><span class="type">AccessibleStateSet</span></a> *obj</code></em>,
54
<em class="parameter"><code><a class="link" href="at-spi-cspi-State-and-StateSets.html#AccessibleState" title="enum AccessibleState"><span class="type">AccessibleState</span></a> state</code></em>);
63
57
<div class="refsect1" title="Description">
114
108
} AccessibleState;
117
The possibles states of an object.</p>
111
The possibles states of an object.
120
113
<div class="variablelist"><table border="0">
121
114
<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
<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>
130
<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>
135
<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>
140
<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>
145
<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>
150
<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>
155
<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>
160
<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>
165
<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>
170
<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>
175
<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>
180
<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>
185
<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>
190
<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>
195
<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>
200
<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>
205
<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>
210
<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>
215
<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>
220
<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>
225
<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>
230
<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>
235
<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>
240
<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>
245
<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>
250
<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>
255
<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>
260
<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>
265
<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>
270
<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>
275
<td> Indicates that "active-descendant-changed"
117
<td><p><a name="SPI-STATE-INVALID:CAPS"></a><span class="term"><code class="literal">SPI_STATE_INVALID</code></span></p></td>
118
<td>Indicates an invalid state
122
<td><p><a name="SPI-STATE-ACTIVE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_ACTIVE</code></span></p></td>
123
<td>Indicates a window is currently the active window
127
<td><p><a name="SPI-STATE-ARMED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_ARMED</code></span></p></td>
128
<td>Indicates that the object is armed
132
<td><p><a name="SPI-STATE-BUSY:CAPS"></a><span class="term"><code class="literal">SPI_STATE_BUSY</code></span></p></td>
133
<td>Indicates the current object is busy
137
<td><p><a name="SPI-STATE-CHECKED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_CHECKED</code></span></p></td>
138
<td>Indicates this object is currently checked
142
<td><p><a name="SPI-STATE-COLLAPSED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_COLLAPSED</code></span></p></td>
143
<td>Indicates this object is collapsed
147
<td><p><a name="SPI-STATE-DEFUNCT:CAPS"></a><span class="term"><code class="literal">SPI_STATE_DEFUNCT</code></span></p></td>
148
<td>Indicates the user interface object corresponding to this object no longer exists
152
<td><p><a name="SPI-STATE-EDITABLE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_EDITABLE</code></span></p></td>
153
<td>Indicates the user can change the contents of this object
157
<td><p><a name="SPI-STATE-ENABLED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_ENABLED</code></span></p></td>
158
<td>Indicates that this object is enabled
162
<td><p><a name="SPI-STATE-EXPANDABLE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_EXPANDABLE</code></span></p></td>
163
<td>Indicates this object allows progressive disclosure of its children
167
<td><p><a name="SPI-STATE-EXPANDED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_EXPANDED</code></span></p></td>
168
<td>Indicates this object its expanded
172
<td><p><a name="SPI-STATE-FOCUSABLE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_FOCUSABLE</code></span></p></td>
173
<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
177
<td><p><a name="SPI-STATE-FOCUSED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_FOCUSED</code></span></p></td>
178
<td>Indicates this object currently has the keyboard focus
182
<td><p><a name="SPI-STATE-HORIZONTAL:CAPS"></a><span class="term"><code class="literal">SPI_STATE_HORIZONTAL</code></span></p></td>
183
<td>Indicates the orientation of thsi object is horizontal
187
<td><p><a name="SPI-STATE-ICONIFIED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_ICONIFIED</code></span></p></td>
188
<td>Indicates this object is minimized and is represented only by an icon
192
<td><p><a name="SPI-STATE-MODAL:CAPS"></a><span class="term"><code class="literal">SPI_STATE_MODAL</code></span></p></td>
193
<td>Indicates something must be done with this object before the user can interact with an object in a different window
197
<td><p><a name="SPI-STATE-MULTI-LINE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_MULTI_LINE</code></span></p></td>
198
<td>Indicates this (text) object can contain multiple lines of text
202
<td><p><a name="SPI-STATE-MULTISELECTABLE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_MULTISELECTABLE</code></span></p></td>
203
<td>Indicates this object allows more than one of its children to be selected at the same time
207
<td><p><a name="SPI-STATE-OPAQUE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_OPAQUE</code></span></p></td>
208
<td>Indicates this object paints every pixel within its rectangular region
212
<td><p><a name="SPI-STATE-PRESSED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_PRESSED</code></span></p></td>
213
<td>Indicates this object is currently pressed
217
<td><p><a name="SPI-STATE-RESIZABLE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_RESIZABLE</code></span></p></td>
218
<td>Indicates the size of this object is not fixed
222
<td><p><a name="SPI-STATE-SELECTABLE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTABLE</code></span></p></td>
223
<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
227
<td><p><a name="SPI-STATE-SELECTED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTED</code></span></p></td>
228
<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
232
<td><p><a name="SPI-STATE-SENSITIVE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_SENSITIVE</code></span></p></td>
233
<td>Indicates this object is sensitive
237
<td><p><a name="SPI-STATE-SHOWING:CAPS"></a><span class="term"><code class="literal">SPI_STATE_SHOWING</code></span></p></td>
238
<td>Indicates this object, the object's parent, the object's parent's parent, and so on, are all visible
242
<td><p><a name="SPI-STATE-SINGLE-LINE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_SINGLE_LINE</code></span></p></td>
243
<td>Indicates this (text) object can contain only a single line of text
247
<td><p><a name="SPI-STATE-STALE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_STALE</code></span></p></td>
248
<td>Indicates that the index associated with this object has changed since the user accessed the object
252
<td><p><a name="SPI-STATE-TRANSIENT:CAPS"></a><span class="term"><code class="literal">SPI_STATE_TRANSIENT</code></span></p></td>
253
<td>Indicates this object is transient
257
<td><p><a name="SPI-STATE-VERTICAL:CAPS"></a><span class="term"><code class="literal">SPI_STATE_VERTICAL</code></span></p></td>
258
<td>Indicates the orientation of this object is vertical
262
<td><p><a name="SPI-STATE-VISIBLE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_VISIBLE</code></span></p></td>
263
<td>Indicates this object is visible
267
<td><p><a name="SPI-STATE-MANAGES-DESCENDANTS:CAPS"></a><span class="term"><code class="literal">SPI_STATE_MANAGES_DESCENDANTS</code></span></p></td>
268
<td>Indicates that "active-descendant-changed"
276
269
event is sent when children become 'active' (i.e. are selected or navigated
277
270
to onscreen). Used to prevent need to enumerate all children in very large
278
271
containers, like tables.
282
<td><p><a name="SPI-STATE-INDETERMINATE--CAPS"></a><span class="term"><code class="literal">SPI_STATE_INDETERMINATE</code></span></p></td>
283
<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>
288
<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>
293
<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>
298
<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>
303
<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>
275
<td><p><a name="SPI-STATE-INDETERMINATE:CAPS"></a><span class="term"><code class="literal">SPI_STATE_INDETERMINATE</code></span></p></td>
276
<td>Indicates that a check box is in a state other than checked or not checked.
280
<td><p><a name="SPI-STATE-TRUNCATED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_TRUNCATED</code></span></p></td>
281
<td>Indicates that an object is truncated, e.g. a text value in a speradsheet cell.
285
<td><p><a name="SPI-STATE-REQUIRED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_REQUIRED</code></span></p></td>
286
<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.
290
<td><p><a name="SPI-STATE-INVALID-ENTRY:CAPS"></a><span class="term"><code class="literal">SPI_STATE_INVALID_ENTRY</code></span></p></td>
291
<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.
295
<td><p><a name="SPI-STATE-SUPPORTS-AUTOCOMPLETION:CAPS"></a><span class="term"><code class="literal">SPI_STATE_SUPPORTS_AUTOCOMPLETION</code></span></p></td>
296
<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>.
300
<td><p><a name="SPI-STATE-SELECTABLE-TEXT:CAPS"></a><span class="term"><code class="literal">SPI_STATE_SELECTABLE_TEXT</code></span></p></td>
308
301
<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>
313
<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>
318
<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>
323
<td> Not a valid state, used for finding end of enumeration
305
<td><p><a name="SPI-STATE-IS-DEFAULT:CAPS"></a><span class="term"><code class="literal">SPI_STATE_IS_DEFAULT</code></span></p></td>
306
<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.
310
<td><p><a name="SPI-STATE-VISITED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_VISITED</code></span></p></td>
311
<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".
315
<td><p><a name="SPI-STATE-LAST-DEFINED:CAPS"></a><span class="term"><code class="literal">SPI_STATE_LAST_DEFINED</code></span></p></td>
316
<td>Not a valid state, used for finding end of enumeration