Control Pattern Mapping for UI Automation Clients

System_CAPS_ICON_note.jpg 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.

System_CAPS_ICON_note.jpg 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.

Control TypeSupportedConditional SupportNot Supported
ButtonNoneInvoke, Toggle, Expand CollapseNone
CalendarGrid, TableSelection, ScrollValue
Check BoxToggleNoneNone
Combo BoxExpand CollapseSelection, ValueScroll
Data GridGridScroll, Selection, TableNone
Data ItemSelection ItemExpand Collapse, Grid Item, Scroll Item, Table, Toggle, ValueNone
DocumentTextScroll, ValueNone
EditNoneText, Range Value, ValueNone
GroupNoneExpand CollapseNone
Header ItemNoneTransform, InvokeNone
ImageNoneGrid Item, Table ItemInvoke, Selection Item
ListNoneGrid, Multiple View, Scroll, SelectionTable
List ItemSelection ItemExpand Collapse, Grid Item, Invoke, Scroll Item, Toggle, ValueNone
Menu BarNoneExpand Collapse, Dock, TransformNone
Menu ItemNoneExpand Collapse, Invoke, Selection Item, ToggleNone
PaneNoneDock. Scroll, TransformWindow
Progress BarNoneRange Value, ValueNone
Radio ButtonSelection ItemNoneToggle
Scroll BarNoneRange ValueScroll
SliderNoneRange Value, Selection, ValueNone
SpinnerNoneRange Value, Selection, ValueNone
Split ButtonInvoke, Expand CollapseNoneNone
Status BarNoneGridNone
Tab ItemSelection ItemNoneInvoke
TableGrid, Grid Item, Table, Table ItemNoneNone
TextNoneGrid Item, Table Item, TextValue
Title BarNoneNoneNone
Tool BarNoneDock, Expand Collapse, TransformNone
Tool TipNoneText, WindowNone
TreeNoneScroll, SelectionNone
Tree ItemExpand CollapseInvoke, Scroll Item, Selection Item, ToggleNone
WindowTransform, WindowDockNone
System_CAPS_ICON_note.jpg 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.

UI Automation Overview