UIAPro

UIA Pro is supported as a technical preview.

UIAPro

UIAPro namespace

Classes

AppBar
AppBarTO
Button
ButtonTO
Calendar
CalendarTO
CheckBox
CheckBoxTO
ComboBox
ComboBoxTO
Document
DocumentTO
Edit
EditTO
ExpandCollapsePattern
Grid
GridItem
GridItemPattern
GridItemTO
GridPattern
GridTO
Group
GroupTO
Header
HeaderItem
HeaderItemTO
HeaderTO
Image
ImageTO
InvokePattern
LegacyAccessiblePattern
Link
LinkTO
List
ListItem
ListItemTO
ListTO
Menu
MenuBar
MenuBarTO
MenuItem
MenuItemTO
MenuTO
Pane
PaneTO
ProgressBar
ProgressBarTO
RadioButton
RadioButtonTO
RangeValuePattern
ScrollBar
ScrollBarTO
ScrollItemPattern
ScrollPattern
SelectionItemPattern
SelectionPattern
SemanticZoom
SemanticZoomTO
Separator
SeparatorTO
Slider
SliderTO
Spinner
SpinnerTO
SplitButton
SplitButtonTO
StatusBar
StatusBarTO
TabControl
TabControlTO
TabItem
TabItemTO
Table
TableItemPattern
TablePattern
TableTO
Text
TextPattern
TextTO
Thumb
ThumbTO
TitleBar
TitleBarTO
TogglePattern
ToolBar
ToolBarTO
ToolTip
ToolTipTO
TreeView
TreeViewItem
TreeViewItemTO
TreeViewTO
UiObject
UiObjectTO
ValuePattern
Window
WindowPattern
WindowTO

Type Definitions

AccessibleRole

Describe the roles of various UI objects in an application.

Type:

Properties:

NameTypeDescription
titleBarstringThe object represents a title or caption bar for a window.
menuBarstringThe object represents the menu bar (positioned beneath the title bar of a window) from which users select menus.
scrollBarstringThe object represents a vertical or horizontal scroll bar, which is part of the client area or is used in a control.
gripstringThe object represents a special mouse pointer that allows a user to manipulate user interface elements such as windows. One example of this involves resizing a window by dragging its lower-right corner.
soundstringThe object represents a system sound, which is associated with various system events.
cursorstringThe object represents the system's mouse pointer.
caretstringThe object represents the system's caret.
alertstringThe object represents an alert or a condition that a user should be notified about. This role is used only for objects that embody an alert but are not associated with another user interface element, such as a message box, graphic, text, or sound.
windowstringThe object represents the window frame, which contains child objects such as a title bar, client, and other objects of a window.
clientstringThe object represents a window's client area. Microsoft Active Accessibility uses this role as a default if there is a question about the role of a UI element.
menuPopupstringThe object represents a menu: a list of options, each with a specific action. All menu types must have a role, including the drop-down menus which are displayed when selected from a menu bar; and shortcut menus, which are displayed by clicking the right mouse button.
menuItemstringThe object represents a menu item: an menu entry that the user can choose to carry out a command, select an option, or display another menu. Functionally, a menu item is equivalent to a push button, a radio button, a check box, or a menu.
toolTipstringThe object represents a tooltip that provides helpful hints.
applicationstringThe object represents a main window for an application.
documentstringThe object represents a document window. A document window is always contained within an application window. This role applies only to MDI windows and refers to the object that contains the MDI title bar.
panestringThe object represents a pane within a frame or a document window. Thus, panes represent a grouping level that is lower than frames or document windows, but higher than individual controls. The user navigates between panes by pressing TAB, F6, or CTRL+TAB, depending on the context.
chartstringThe object represents a graphical image used to chart data.
dialogstringThe object represents a dialog box or message box.
borderstringThe object represents a window border. The entire border is represented by a single object rather than by separate objects for each side.
groupingstringThe object logically groups other objects. There is not always a parent-child relationship between the grouping object and the objects it contains.
separatorstringThe object is used to visually divide a space into two regions. Examples of separator objects include a separator menu item, and a bar that divides split panes within a window.
toolBarstringThe object represents a toolbar, which is a grouping of controls that provides easy access to frequently used features.
statusBarstringThe object represents 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. The status bar has multiple fields, which display different kinds of information.
tablestringThe object represents a table that contains rows and columns of cells, and, optionally, row headers and column headers.
columnHeaderstringThe object represents a column header, providing a visual label for a column in a table.
rowHeaderstringThe object represents a row header, which provides a visual label for a table row.
columnstringThe object represents a column of cells within a table.
rowstringThe object represents a row of cells within a table.
cellstringThe object represents a cell within a table.
linkstringThe object represents a link to something else. This object might look like text or a graphic, but it acts like a button.
helpBalloonstringThe object displays a help topic in the form of a tooltip or help balloon.
characterstringThe object represents a cartoon-like graphic object, such as Microsoft Office Assistant, which is displayed to provide help to users of an application.
liststringThe object represents a list box, allowing the user to select one or more items.
listItemstringThe object represents an item in a list box or in the list portion of a combo box, drop-down list box, or drop-down combo box.
outlinestringThe object represents an outline or a tree structure, such as a tree view control, that displays a hierarchical list and allows the user to expand and collapse branches.
outlineItemstringThe object represents an item that navigates like an outline item. The UP and DOWN ARROW keys are used to navigate through the outline. However, instead of expanding and collapsing when the LEFT and RIGHT ARROW key is pressed, these menus expand or collapse when the SPACEBAR or ENTER key is pressed and the item has focus.
pageTabstringThe object represents a page tab. The only child of a page tab control is a ROLE_SYSTEM_GROUPING object that has the contents of the associated page.
propertyPagestringThe object represents a property sheet.
indicatorstringThe object represents an indicator, such as a pointer graphic, that points to the current item.
graphicstringThe object represents a picture.
staticTextstringThe object represents read-only text, such as labels for other controls or instructions in a dialog box. Static text cannot be modified or selected.
textstringThe object represents selectable text that allows edits or is designated as read-only.
pushButtonstringThe object represents a push-button control.
checkButtonstringThe object represents a check box control: an option that is selected or cleared independently of other options.
radioButtonstringThe object represents an option button (formerly, a radio button). It is one of a group of mutually exclusive options. All objects that share the same parent and that have this attribute are assumed to be part of a single mutually exclusive group. To divide these objects into separate groups, use ROLE_SYSTEM_GROUPING objects.
comboBoxstringThe object represents a combo box: an edit control with an associated list box that provides a set of predefined choices.
dropListstringThe object represents the calendar control, SysDateTimePick32. The Microsoft Active Accessibility runtime component uses this role to indicate that either a date or a calendar control has been found.
progressBarstringThe object represents a progress bar, which dynamically shows how much of an operation in progress has completed. This control takes no user input.
dialstringThe object represents a dial or knob.
hotKeyFieldstringThe object represents a keyboard shortcut field that allows the user to enter a combination or sequence of keystrokes.
sliderstringThe object represents a slider, which allows the user to adjust a setting in particular increments between minimum and maximum values.
spinButtonstringThe object represents a spin box, which is a control that allows the user to increment or decrement the value displayed in a separate "buddy" control that is associated with the spin box.
diagramstringThe object represents a graphical image that is used to diagram data.
animationstringThe object represents an animation control whose content changes over time, such as a control that displays a series of bitmap frames. Animation controls are displayed when files are copied or when some other time-consuming task is performed.
equationstringThe object represents a mathematical equation.
buttonDropDownstringThe object represents a button that expands a list of items.
buttonMenustringThe object represents a button that expands a menu.
buttonDropDownGridstringThe object represents a button that expands a grid.
whiteSpacestringThe object represents blank space between other objects.
pageTabListstringThe object represents a container of page tab controls.
clockstringThe object represents a control that displays time.
splitButtonstringThe object represents a button on a toolbar that has a drop-down list icon that is directly adjacent to the button.
ipAddressstringThe object represents an edit control that is designed for an IP address. The edit control is divided into sections, each for a specific part of the IP address.
outlineButtonstringThe object represents an item that navigates like an outline item. The UP and DOWN ARROW keys are used to navigate through the outline. However, instead of expanding and collapsing when the LEFT and RIGHT ARROW key is pressed, these menus expand or collapse when the SPACEBAR or ENTER key is pressed and the item has focus.

AccessibleState

Describe the state of objects in an application UI.

Type:

Properties:

NameTypeDescription
unavailablestringThe object is unavailable.
selectedstringThe object is selected.
focusedstringThe object has the keyboard focus. Do not confuse object focus with object selection. For more information, see Selection and Focus Properties and Methods. For objects with this object state, send the EVENT_OBJECT_SHOW or EVENT_OBJECT_HIDE WinEvents to notify client applications about state changes. Do not use EVENT_OBJECT_STATECHANGE.
pressedstringThe object is pressed.
checkedstringThe object's check box is selected.
mixedstringIndicates that the state of a three-state check box or toolbar button is not determined. The check box is neither selected nor cleared and is therefore in the third or mixed state.
readOnlystringThe object is designated read-only.
hotTrackedstringThe object is hot-tracked by the mouse, which means that the object's appearance has changed to indicate that the mouse pointer is located over it.
defaultstringThis state represents the default button in a window.
expandedstringThe object's children that have the UIAPro.AccessibleRole.outlineItem role are displayed.
collapsedstringThe object's children that have the UIAPro.AccessibleRole.outlineItem role are hidden.
busystringThe control cannot accept input at this time.
floatingstringThe object is not clipped to the boundary of its parent object, and it does not move automatically when the parent moves.
marqueedstringThe object represents a main window for an application.
animatedstringThe object's appearance changes rapidly or constantly. Graphics that are animated occasionally are described as UIAPro.AccessibleRole.graphic with the State property set to UIAPro.AccessibleState.animated. This state is used to indicate that the object's location is changing.
invisiblestringThe object is programmatically hidden. For example, menu items are programmatically hidden until a user activates the menu. Because objects with this state are not available to users, client applications must not communicate information about the object to users. However, if client applications find an object with this state, they should check whether UIAPro.AccessibleState.offScreen is also set. If this second state is defined, clients can communicate the information about the object to users. For example, a list box can have both UIAPro.AccessibleState.invisible and UIAPro.AccessibleState.offScreen set. In this case, the client application can communicate all items in the list to users. If a client application is navigating through an IAccessible tree and encounters a parent object that is invisible, Microsoft Active Accessibility will not expose information about any possible children of the parent as long as the parent is invisible.
offScreenstringThe object is clipped or has scrolled out of view, but it is not programmatically hidden. If the user makes the viewport larger, more of the object will be visible on the computer screen.
sizeablestringThe object can be resized. For example, a user could change the size of a window by dragging it by the border.
moveablestringIndicates that the object can be moved. For example, a user can click the object's title bar and drag the object to a new location.
selfVoicingstringThe object or child uses text-to-speech (TTS) technology for description purposes. When an object with this state has the focus, a speech-based accessibility aid does not announce information because the object automatically announces it.
focusablestringThe object is on the active window and is ready to receive keyboard focus.
selectablestringThe object accepts selection.
linkedstringIndicates that the object is formatted as a hyperlink. The object's role will usually be UIAPro.AccessibleRole.text.
traversedstringThe object is a hyperlink that has been visited (previously clicked) by a user.
multiSelectablestringIndicates that the object accepts multiple selected items; that is, UIAPro.SelectOptions.addSelection for the IAccessible::accSelect method is valid.
extendSelectablestringIndicates that an object extends its selection by using UIAPro.SelectOptions.extendSelection in the IAccessible::accSelect method.
alertLowstringIndicates low-priority information that is not important to the user. This state is used, for example, when Word changes the appearance of the TipWizard button on its toolbar to indicate that it has a hint for the user.
alertMediumstringIndicates important information that is not conveyed immediately to the user. For example, when a battery is starting to reach a low level, a level indicator generates a medium-level alert. A blind access tool then generates a sound to let the user know that important information is available, without actually interrupting the user's work. The user could then query the alert information when convenient.
alertHighstringIndicates important information to be immediately conveyed to the user. For example, when a battery reaches a critically low level, a level indicator generates a high-level alert. As a result, a blind access tool immediately announces this information to the user, and a screen magnification program scrolls the screen so that the battery indicator is in view. This state is also appropriate for any prompt or operation that must be completed before the user can continue.
protectedstringThe object is a password-protected edit control.

Alignment

Represents pre-defined units of alignment.

Type:

Properties:

NameTypeDescription
topstringSpecifies that the alignment is on the top.
bottomstringSpecifies that the alignment is on the bottom.

Direction

Represents pre-defined units of direction for the purposes of navigation within a document.

Type:

Properties:

NameTypeDescription
forwardstringSpecifies that the direction is forward.
backwardstringSpecifies that the direction is backward.

PatternType

The supported UIA Pro control patterns.

Type:

Properties:

NameTypeDescription
expandCollapsestringA UIA Pro ExpandCollapse pattern.
gridItemstringA UIA Pro GridItem pattern.
gridstringA UIA Pro Grid pattern.
invokestringA UIA Pro Invoke pattern.
legacyAccessiblestringA UIA Pro LegacyAccessible pattern.
valuestringA UIA Pro Value pattern.
rangeValuestringA UIA Pro RangeValue pattern.
scrollItemstringA UIA Pro ScrollItem pattern.
scrollstringA UIA Pro Scroll pattern.
selectionItemstringA UIA Pro SelectionItem pattern.
selectionstringA UIA Pro Selection pattern.
tableItemstringA UIA Pro TableItem pattern.
tablestringA UIA Pro Table pattern.
textstringA UIA Pro Text pattern.
togglestringA UIA Pro Toggle pattern.
windowstringA UIA Pro Window pattern.

ScrollAmount

Contains values used by UIAPro.ScrollPattern to indicate the direction and distance to scroll.

Type:

Properties:

NameTypeDescription
smallIncrementstringSpecifies that scrolling is done in small increments, equivalent to pressing an arrow key or clicking the arrow button on a scrollbar.
largeIncrementstringSpecifies that scrolling is done in large increments, equivalent to a PageDown or clicking on the track of a scrollbar component. If a PageDown is not a relevant amount for the control and/or no scrollbar exists, the value represents an amount equal to the current visible region.
smallDecrementstringSpecifies that scrolling is done in small decrements, equivalent to pressing an arrow key or clicking the arrow button on a scrollbar.
largeDecrementstringSpecifies that scrolling is done in large decrements, equivalent to PageUp or clicking on a blank part of a scrollbar. If PageUp is not a relevant amount for the control and/or no scrollbar exists, the value represents an amount equal to the current visible window.

SelectOptions

Constant values used to specify how an accessible object becomes selected or takes the focus.

Type:

Properties:

NameTypeDescription
takeFocusstringSets the focus to the object and makes it the selection anchor. Used by itself, this flag does not alter 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.
takeSelectionstringSelects the object and removes the selection from all other objects in the container. Unless it is combined with UIAPro.SelectOptions.takeFocus, this flag does not change the focus or the selection anchor. The UIAPro.SelectOptions.takeSelection | UIAPro.SelectOptions.takeFocus combination is equivalent to single-clicking an item in Windows Explorer.
extendSelectionstringAlters 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. Set the selection state by combining this flag with UIAPro.SelectOptions.addSelection or UIAPro.SelectOptions.removeSelection. Unless it is combined with UIAPro.SelectOptions.takeFocus, this flag does not change the focus or the selection anchor. The UIAPro.SelectOptions.extendSelection | UIAPro.SelectOptions.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. This flag is not combined with UIAPro.SelectOptions.takeSelection.
addSelectionstringAdds the object to the current selection; possible result is a noncontiguous selection. Unless it is combined with UIAPro.SelectOptions.takeFocus, this flag does not change the focus or the selection anchor. The UIAPro.SelectOptions.addSelection | UIAPro.SelectOptions.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. This flag is not combined with UIAPro.SelectOptions.removeSelection or UIAPro.SelectOptions.takeSelection.
removeSelectionstringRemoves the object from the current selection; possible result is a noncontiguous selection. Unless it is combined with UIAPro.SelectOptions.takeFocus, this flag does not change the focus or the selection anchor. The UIAPro.SelectOptions.removeSelection | UIAPro.SelectOptions.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. This flag is not combined with UIAPro.SelectOptions.addSelection or UIAPro.SelectOptions.takeSelection.

SupportedTextSelection

Contains values that specify whether a text provider supports selection and, if so, whether it supports a single, continuous selection or multiple, disjointed selections.

Type:

Properties:

NameTypeDescription
multiplestringSupports multiple, disjoint text selections.
nonestringDoes not support text selections.
singlestringSupports a single, continuous text selection.

TableTraversalDirection

Contains values that specify whether data in a table should be read primarily by row or by column.

Type:

Properties:

NameTypeDescription
rowByRowstringSpecifies that data in the table should be read column by column.
columnByColumnstringSpecifies that the best way to present the data is indeterminate.
indeterminatestringSpecifies that data in the table should be read row by row.

TextUnit

Represents pre-defined units of text for the purposes of navigation within a document.

Type:

Properties:

NameTypeDescription
linestringSpecifies that the text unit is one line in length.
pagestringSpecifies that the text unit is one document-specific page in length.

WindowInteractionState

Contains values used by UIAPro.WindowPattern to indicate the window interaction state.

Type:

Properties:

NameTypeDescription
runningstringIndicates that the window is running. This does not guarantee that the window is responding or ready for user interaction.
closingstringIndicates that the window is closing.
readyForUserInteractionstringIndicates that the window is ready for user interaction.
blockedByModalWindowstringIndicates that the window is blocked by a modal window.
notRespondingstringIndicates that the window is not responding.

WindowVisualState

Contains values used by UIAPro.WindowPattern to indicate the window visual state.

Type:

Properties:

NameTypeDescription
normalstringSpecifies that the window is normal (restored).
maximizedstringSpecifies that the window is maximized.
minimizedstringSpecifies that the window is minimized.