UIA Pro Enumerations
This topic describes sets of values used by the UIA Pro methods. When using these values as method arguments, you can pass either the numeric or string value.
When receiving these values from a method:
The legacy UIA Pro Add-in returns the numeric value.
The enhanced Beta UI Pro Add-in returns the string value.
AccessibleRole values
The table below describes the possible values for the AccessibleRole enumeration.
AccessibleState values
The table below describes the possible values for the AccessibleState enumeration.
| Integer value | String value | Description |
|---|---|---|
| 0 | Normal | The object has no state or is in a default state. |
| 1 | Unavailable | The object is unavailable. |
| 2 | Selected | The object is selected. |
| 4 | Focused | The object has the keyboard focus. |
| 8 | Pressed | The object is pressed. |
| 16 | Checked | The object's check box is selected. |
| 32 | Mixed | The state of a three-state check box or toolbar button is not determined (neither selected nor cleared). |
| 64 | ReadOnly | The object is designated read-only. |
| 128 | HotTracked | The object's appearance has changed to indicate that the mouse pointer is located over it. |
| 256 | Default | This is the default button in a window. |
| 512 | Expanded | The object's children that have the OutlineItem role are displayed. |
| 1024 | Collapsed | The object's children that have OutlineItem role are hidden. |
| 2048 | Busy | The control cannot accept input at this time. |
| 4096 | Floating | The object is not clipped to the boundary of its parent object, and it does not move automatically when the parent moves. |
| 8192 | Marqueed | Indicates scrolling or moving text or graphics. |
| 16384 | Animated | The object's appearance changes rapidly or constantly. |
| 32768 | Invisible | The object is programmatically hidden. For example, menu items are hidden until the menu is opened. |
65536 | OffScreen | The object is clipped or scrolled out of view, but it is not programmatically hidden. |
131072 | Sizeable | The object can be resized. For example, you can change the size of a window by dragging it by the border. |
| 262144 | Moveable | The object can be moved. For example, you can click the object's title bar and drag the object to a new location. |
| 524288 | SelfVoicing | The object uses text-to-speech (TTS) technology to describe or announce itself. |
| 1048576 | Focusable | The object is on the active window and is ready to receive keyboard focus. |
| 2097152 | Selectable | The object can be selected. |
| 4194304 | Linked | The object is formatted as a hyperlink. The object's role is usually Text. |
| 8388608 | Traversed | The object is a hyperlink that has been visited (previously clicked). |
| 16777216 | MultiSelectable | In this object, multiple items can be selected. |
| 33554432 | ExtendSelectable | The selection of items in this object can be extended. |
| 67108864 | AlertLow | Low-priority information that is not important to the user. |
| 134217728 | AlertMedium | Important information that is not conveyed immediately to the user. |
| 268435456 | AlertHigh | Important information to be immediately conveyed to the user. |
| 536870912 | Protected | The object is a password-protected edit control. |
SelectOptions values
The table below describes the possible values for the SelectOptions enumeration.
| Integer value | String value | Description |
|---|---|---|
| 1 | TakeFocus | Sets the focus to the object and makes it the selection anchor. This flag affects only the focus, not the selection. The effect is similar to moving the focus manually by pressing an ARROW key while holding down the CTRL key in Windows Explorer or in any multiple-selection list box. |
| 2 | TakeSelection | Selects the object and clears any previously selected objects in the container. To change the focus or the selection anchor in addition to selecting the object, combine this flag with TakeFocus. TakeSelection | TakeFocus is equivalent to single-clicking an item in Windows Explorer. |
| 4 | ExtendSelection | Alters the selection so that all objects between the selection anchor and this object take on the anchor object's selection state. If the anchor object is not selected, the objects are removed from the selection. If the anchor object is selected, the selection is extended to include this object and all the objects in between. To specify the selection state to set, combine this flag with AddSelection or RemoveSelection. To change the focus or the selection anchor in addition to setting the objects' selection state, combine this flag with TakeFocus. The ExtendSelection | TakeFocus combination is equivalent to adding an item to a selection manually by holding down the SHIFT key and clicking an unselected object in Windows Explorer. Do not combine this flag with TakeSelection. |
| 8 | AddSelection | Adds the object to the current selection; can result in a noncontiguous selection. To change the focus or the selection anchor in addition to selecting the objects, combine this flag with TakeFocus. The AddSelection | TakeFocus combination is equivalent to adding an item to a selection manually by holding down the CTRL key and clicking an unselected object in Windows Explorer. Do not combine this flag with RemoveSelection or TakeSelection. |
| 16 | RemoveSelection | Removes the object from the current selection; can result in a noncontiguous selection. To change the focus or the selection anchor in addition to deselecting the objects, combine this flag with TakeFocus. The RemoveSelection | TakeFocus combination is equivalent to removing an item from a selection manually by holding down the CTRL key while clicking a selected object in Windows Explorer. Do not combine this flag with AddSelection or TakeSelection. |

