UI Automation Control Patterns Overview
A control pattern is an interface implementation that exposes a particular aspect of a control's functionality to Microsoft UI Automation client applications. Clients use the properties and methods exposed through a control pattern to retrieve information about a particular capability of the control, or to manipulate a particular aspect of the control's behavior. For example, a control that presents a tabular interface uses the Grid control pattern to expose the number of rows and columns in the table, and to enable a client to retrieve items from the table.
UI Automation uses control patterns to represent common control behaviors. For example, you use the IUIAutomationInvokePattern control pattern for controls that can be invoked, such as buttons, and the IUIAutomationScrollPattern control pattern for controls that have scroll bars, such as list boxes, list views, or combo boxes. Because each control pattern represents a separate functionality, control patterns can be combined to describe the full set of functionality supported by a particular control.
This topic contains the following sections:
- UI Automation Control Pattern Components
- Control Patterns in Providers and Clients
- Dynamic Control Patterns
- Control Pattern Interfaces
- Related Topics
Control patterns support methods, properties, events, and relationships that are required to define a discrete piece of functionality available in a control.
- The methods allow UI Automation clients to manipulate the control.
- The properties and events provide information about the functionality and state of the control.
- The relationship between a UI Automation element and its parent, children, and siblings describes the element structure in the UI Automation tree.
Control patterns relate to controls similar to the way interfaces relate to Component Object Model (COM) objects. In COM, you can query an object to ask what interfaces it supports, and then use those interfaces to access functionality. In UI Automation, clients can ask a control which control patterns it supports, and then interact with the control through the properties, methods, events, and structures exposed by the supported control patterns.
UI Automation providers implement control pattern interfaces to expose the appropriate behavior for a specific piece of functionality that is supported by the control. These interfaces are not directly exposed to clients, but are used by the UI Automation core to implement another set of client interfaces. For example, a provider exposes scrolling functionality to UI Automation through IScrollProvider, and UI Automation exposes the functionality to clients through IUIAutomationScrollPattern.
Some controls do not always support the same set of control patterns. For example, a multiline edit control enables vertical scrolling only when it contains more lines of text than can be displayed in its viewable area. Scrolling is disabled when enough text is removed so that scrolling is no longer required. For this example, IUIAutomationScrollPattern is supported dynamically, depending on the how much text is in the edit box.
The following table describes the UI Automation control patterns. The table also lists the client interfaces used to access the control patterns, and the provider interfaces used to implement them.
|Provider interface||Client interface||Description|
|IDockProvider||IUIAutomationDockPattern||Used for controls that can be docked in a docking container, for example, toolbars or tool palettes.|
|IExpandCollapseProvider||IUIAutomationExpandCollapsePattern||Used for controls that can be expanded or collapsed, for example, menu items in an application, such as the File menu.|
|IGridProvider||IUIAutomationGridPattern||Used for controls that support grid functionality, such as sizing and moving to a specified cell, for example, the large icon view in Windows Explorer or simple tables in Microsoft Office Word.|
|IGridItemProvider||IUIAutomationGridItemPattern||Used for controls that have cells in grids. The individual cells should support the GridItem pattern, for example, each cell in Windows Explorerdetail view.|
|IInvokeProvider||IUIAutomationInvokePattern||Used for controls that can be invoked, such as buttons.|
|IItemContainerProvider||IUIAutomationItemContainerPattern||Used for controls that can contain other items.|
|ILegacyIAccessibleProvider||IUIAutomationLegacyIAccessiblePattern||Used to expose Microsoft Active Accessibility properties and methods to UI Automation clients.|
|IMultipleViewProvider||IUIAutomationMultipleViewPattern||Used for controls that can switch between multiple representations of the same set of information, data, or children, for example, a list view control where data is available in thumbnail, tile, icon, list, or detail views.|
|IRangeValueProvider||IUIAutomationRangeValuePattern||Used for controls that have a range of values. For example, a spinner control that displays years might have a range of 1900–2010, while a spinner control that displays months would have a range of 1–12.|
|IScrollProvider||IUIAutomationScrollPattern||Used for controls that can scroll when there is more information than can be displayed in the viewable area of the control.|
|IScrollItemProvider||IUIAutomationScrollItemPattern||Used for controls that have individual items in a list that scrolls, for example, a list control in a combo box control.|
|ISelectionProvider||IUIAutomationSelectionPattern||Used for selection container controls, for example, list boxes and combo boxes.|
|ISelectionItemProvider||IUIAutomationSelectionItemPattern||Used for individual items in selection container controls, such as list boxes and combo boxes.|
|ISynchronizedInputProvider||IUIAutomationSynchronizedInputPattern||Used for controls that accept keyboard or mouse input.|
|ITableProvider||IUIAutomationTablePattern||Used for controls that have a grid and header information.|
|ITableItemProvider||IUIAutomationTableItemPattern||Used for items in a table.|
|ITextProvider||IUIAutomationTextPattern||Used for edit controls and documents that expose textual information.|
|IToggleProvider||IUIAutomationTogglePattern||Used for controls where the state can be toggled, for example, check boxes and checkable menu items.|
|ITransformProvider||IUIAutomationTransformPattern||Used for controls that can be resized, moved, and rotated. Typical uses for the Transform control pattern are in designers, forms, graphical editors, and drawing applications.|
|IValueProvider||IUIAutomationValuePattern||Used for controls that have a value that does not lie within a specified range, for example, a date-time picker.|
|IVirtualizedItemProvider||IUIAutomationVirtualizedItemPattern||Used for controls that work with items in a virtual list.|
|IWindowProvider||IUIAutomationWindowPattern||Used for windows. Examples are top-level application windows, multiple-document interface (MDI) child windows, and dialog boxes.|