Deprecated Control Pattern Functions

Note

The control pattern functions described in this section are deprecated. Client applications should use the Component Object Model (COM) interfaces described in the following sections:

In this section

Function Description
DockPattern_SetDockPosition
[!Note]
This function is deprecated. Client applications should use the Microsoft UI Automation COM interfaces instead.

Docks the UI Automation element at the requested dockPosition within a docking container.
ExpandCollapsePattern_Collapse
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Hides all descendant nodes, controls, or content of the UI Automation element.
ExpandCollapsePattern_Expand
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Expands a control on the screen so that it shows more information.
GridPattern_GetItem
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Gets the node for an item in a grid.
InvokePattern_Invoke
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Sends a request to activate a control and initiate its single, unambiguous action.
ItemContainerPattern_FindItemByProperty
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Retrieves a node within a containing node, based on a specified property value.
LegacyIAccessiblePattern_DoDefaultAction
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Performs the Microsoft Active Accessibility default action for the element.
LegacyIAccessiblePattern_GetIAccessible
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Retrieves an IAccessible object that corresponds to the UI Automation element.
LegacyIAccessiblePattern_Select
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Performs a Microsoft Active Accessibility selection.
LegacyIAccessiblePattern_SetValue
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Sets the Microsoft Active Accessibility value property for the node.
MultipleViewPattern_GetViewName
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Retrieves the name of a control-specific view.
MultipleViewPattern_SetCurrentView
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Sets a control to a different layout.
RangeValuePattern_SetValue
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Sets the value of a control that has a numerical range.
ScrollItemPattern_ScrollIntoView
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Scrolls the content area of a container object in order to display the UI Automation element within the visible region (viewport) of the container.
ScrollPattern_Scroll
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Scrolls the currently visible region of the content area the specified ScrollAmount, horizontally, vertically, or both.
ScrollPattern_SetScrollPercent
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Scrolls a container to a specific position horizontally, vertically, or both.
SelectionItemPattern_AddToSelection
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Adds an unselected element to a selection in a control.
SelectionItemPattern_RemoveFromSelection
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Removes an element from the selection in a selection container.
SelectionItemPattern_Select
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Selects an element in a selection container.
SynchronizedInputPattern_Cancel
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Causes the UI Automation provider to stop listening for mouse or keyboard input.
SynchronizedInputPattern_StartListening
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Causes the UI Automation provider to start listening for mouse or keyboard input.
TextPattern_get_DocumentRange
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Gets the text range for the entire document.
TextPattern_get_SupportedTextSelection
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Ascertains whether the text container's contents can be selected and deselected.
TextPattern_GetSelection
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Gets the current range of selected text from a text container supporting the text pattern.
TextPattern_GetVisibleRanges
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Retrieves an array of disjoint text ranges from a text container where each text range begins with the first partially visible line through to the end of the last partially visible line. For example, a multi-column layout where the columns are partially scrolled out of the visible area of the viewport and the content flows from the bottom of one column to the top of the next.
TextPattern_RangeFromChild
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Gets the text range that a given node spans.
TextPattern_RangeFromPoint
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Retrieves the degenerate (empty) text range nearest to the specified screen coordinates.
TextRange_AddToSelection
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Adds to the existing collection of highlighted text in a text container that supports multiple, disjoint selections by highlighting supplementary text corresponding to the calling text range Start and End endpoints.
TextRange_Clone
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Copies a text range.
TextRange_Compare
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Compares two text ranges.
TextRange_CompareEndpoints
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Returns a value indicating whether two text ranges have identical endpoints.
TextRange_ExpandToEnclosingUnit
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Expands the text range to a larger or smaller unit such as Character, Word, Line, or Page.
TextRange_FindAttribute
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Searches in a specified direction for the first piece of text supporting a specified text attribute.
TextRange_FindText
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Returns the first text range in the specified direction that contains the text the client is searching for.
TextRange_GetAttributeValue
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Gets the value of an text attribute for a text range.
TextRange_GetBoundingRectangles
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Retrieves the minimum number of bounding rectangles that can enclose the range, one rectangle per line.
TextRange_GetChildren
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Returns all UI Automation elements contained within the specified text range.
TextRange_GetEnclosingElement
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Returns the node for the next smallest provider that covers the range.
TextRange_GetText
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Returns the text in a text range, up to a specified number of characters.
TextRange_Move
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Moves the text range the specified number of units requested by the client.
TextRange_MoveEndpointByRange
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Moves an endpoint of one range to the endpoint of another range.
TextRange_MoveEndpointByUnit
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Moves an endpoint of the range the specified number of units.
TextRange_RemoveFromSelection
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Removes the selected text, corresponding to the calling text range TextPatternRangeEndpoint_Start and TextPatternRangeEndpoint_End endpoints, from an existing collection of selected text in a text container that supports multiple, disjoint selections.
TextRange_ScrollIntoView
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Scrolls the text so the specified range is visible in the viewport.
TextRange_Select
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Selects a text range.
TogglePattern_Toggle
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Toggles a control to its next supported state.
TransformPattern_Move
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Moves an element to a specified location on the screen.
TransformPattern_Resize
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Resizes an element on the screen.
TransformPattern_Rotate
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Rotates an element on the screen.
ValuePattern_SetValue
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Sets the text value of an element.
VirtualizedItemPattern_Realize
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Makes the virtual item fully accessible as a UI Automation element.
WindowPattern_Close
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Closes an open window.
WindowPattern_SetWindowVisualState
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Sets the visual state of a window; for example, to maximize a window.
WindowPattern_WaitForInputIdle
[!Note]
This function is deprecated. Client applications should use the UI Automation COM interfaces instead.

Causes the calling code to block for the specified time or until the associated process enters an idle state, whichever completes first.

UI Automation Clients