Control Pattern Mapping for UI Automation Clients

Note

This documentation is intended for .NET Framework developers who want to use the managed UI Automation classes defined in the System.Windows.Automation namespace. For the latest information about UI Automation, see Windows Automation API: UI Automation.

This topic lists control types and their associated control patterns.

The following table organizes the control patterns into the following categories:

  • Supported. The control must support this control pattern.

  • Conditional support. The control may support this control pattern depending on the state of the control.

  • Not supported. The control does not support this control pattern; custom controls may support this control pattern.

Note

Some controls have conditional support for several control patterns depending on the functionality of the control. For example, the menu item control has conditional support for the InvokePattern, ExpandCollapsePattern, TogglePattern, or SelectionItemPattern control pattern, depending on its function in the menu control.

UI Automation Control Patterns for Clients

Control Type Supported Conditional Support Not Supported
Button None Invoke, Toggle, Expand Collapse None
Calendar Grid, Table Selection, Scroll Value
Check Box Toggle None None
Combo Box Expand Collapse Selection, Value Scroll
Data Grid Grid Scroll, Selection, Table None
Data Item Selection Item Expand Collapse, Grid Item, Scroll Item, Table, Toggle, Value None
Document Text Scroll, Value None
Edit None Text, Range Value, Value None
Group None Expand Collapse None
Header None Transform None
Header Item None Transform, Invoke None
Hyperlink Invoke Value None
Image None Grid Item, Table Item Invoke, Selection Item
List None Grid, Multiple View, Scroll, Selection Table
List Item Selection Item Expand Collapse, Grid Item, Invoke, Scroll Item, Toggle, Value None
Menu None None None
Menu Bar None Expand Collapse, Dock, Transform None
Menu Item None Expand Collapse, Invoke, Selection Item, Toggle None
Pane None Dock. Scroll, Transform Window
Progress Bar None Range Value, Value None
Radio Button Selection Item None Toggle
Scroll Bar None Range Value Scroll
Separator None None None
Slider None Range Value, Selection, Value None
Spinner None Range Value, Selection, Value None
Split Button Invoke, Expand Collapse None None
Status Bar None Grid None
Tab Selection Scroll None
Tab Item Selection Item None Invoke
Table Grid, Grid Item, Table, Table Item None None
Text None Grid Item, Table Item, Text Value
Thumb Transform None None
Title Bar None None None
Tool Bar None Dock, Expand Collapse, Transform None
Tool Tip None Text, Window None
Tree None Scroll, Selection None
Tree Item Expand Collapse Invoke, Scroll Item, Selection Item, Toggle None
Window Transform, Window Dock None

Note

If a control type has no supported control patterns listed but has one or more conditionally-supported control patterns, then one of those conditional control patterns will be supported at all times.

See Also

UI Automation Overview