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.

Integer value	String value	Description
1	TitleBar	A title or caption bar for a window
2	MenuBar	A menu bar, from which users select menus, positioned beneath the title bar of a window.
3	ScrollBar	A vertical or horizontal scroll bar, which is part of the client area or is used in a control.
4	Grip	A special mouse pointer used to manipulate user interface elements such as windows. For example, resizing a window by dragging its lower-right corner.
5	Sound	A system sound, which is associated with various system events.
6	Cursor	The system's mouse pointer.
7	Caret	The system’s caret.
8	Alert	An alert or a condition that a user should be notified about. This role is used only for objects that represent an alert but are not associated with another user interface element, such as a message box, graphic, text, or sound.
9	Window	A window frame, which contains child objects such as a title bar, client, and other objects of a window.
10	Client	A window's client area. This is the default role if no other one is known.
11	MenuPopup	A menu: a list of options, each with a specific action. This may be a top-level menu, a context menu, or a child menu.
12	MenuItem	A menu item you can select to carry out a command, select an option, or display another menu.
13	ToolTip	A tooltip that provides helpful hints.
14	Application	A main window for an application.
15	Document	A document window. This role applies only to MDI windows and refers to the object that contains the MDI title bar.
16	Pane	A pane within a frame or a document window. Panes represent a grouping level that is lower than frames or document windows, but higher than individual controls.
17	Chart	A graphical image used to chart data.
18	Dialog	A dialog box or message box.
19	Border	A window border.
20	Grouping	The object logically groups other objects. There is not always a parent-child relationship between the grouping object and the objects it contains.
21	Separator	A visual division of a space into two areas.
22	ToolBar	A toolbar, which is a grouping of controls that provides easy access to frequently used features.
23	StatusBar	A status bar, which is an area at the bottom of a window and which displays information about the current operation, state of the application, or selected object.
24	Table	A table that contains rows and columns of cells, and, optionally, row headers and column headers.
25	ColumnHeader	A column header, providing a visual label for a column in a table.
26	RowHeader	A row header, which provides a visual label for a table row.
27	Column	A column of cells within a table.
28	Row	A row of cells within a table.
29	Cell	A cell within a table.
30	Link	A link object (can look like text or an image).
31	HelpBalloon	A help topic in the form of a tooltip or help balloon.
32	Character	A cartoon-like graphic object, such as Microsoft Office Assistant, which is displayed to provide help to users of an application.
33	List	A list box in which you can select one or more items.
34	ListItem	An item in a list box or in the list portion of a combo box, drop-down list box, or drop-down combo box.
35	Outline	An outline or a tree structure, such as a tree view control, that displays a hierarchical list in which you can expand and collapse branches.
36	OutlineItem	An individual item within an outline or tree structure.
37	PageTab	A page tab. The only child of a page tab control is a grouping object that has the contents of the associated page.
38	PropertyPage	A property sheet.
39	Indicator	An indicator, such as a pointer graphic, that points to the current item.
40	Graphic	A picture.
41	StaticText	Read-only text, such as labels for other controls or instructions in a dialog box. Static text cannot be modified or selected.
42	Text	Selectable text that can be edited or is designated as read-only.
43	PushButton	A push-button control.
44	CheckButton	A check box control: an option that is selected or cleared independently of other options.
45	RadioButton	An option button, which is one of a group of mutually exclusive options.
46	ComboBox	A combo box: an edit control with an associated list box that provides a set of predefined choices.
47	DropList	A SysDateTimePick32 date or calendar control
48	ProgressBar	A progress bar, which dynamically shows how much of an operation in progress has completed.
49	Dial	A dial or knob.
50	HotKeyField	A keyboard shortcut field used to enter a combination or sequence of keystrokes.
51	Slider	A slider,used to adjust a setting in particular increments between minimum and maximum values.
52	SpinButton	A spin box, used to increment or decrement the value displayed in a control next to it.
53	Diagram	A graphical image that is used for diagram data.
54	Animation	An animation control whose content changes over time, such as a control that displays a series of bitmap frames.
55	Equation	A mathematical equation.
56	ButtonDropDown	A button that expands a list of items.
57	ButtonMenu	A button that expands a menu.
58	ButtonDropDownGrid	A button that expands a grid.
59	WhiteSpace	Empty space between objects.
60	PageTabList	A container of page tab controls.
61	Clock	A control that displays time.
62	SplitButton	A button on a toolbar that has a drop-down list icon that is directly adjacent to the button.
63	IpAddress	An edit control that is designed for an IP address.
64	OutlineButton	A clickable button element within an outline or tree structure

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.

UIA Pro Enumerations

AccessibleRole values

AccessibleState values

Send Help Center Feedback