ITextRangeProvider Interface

Exposes methods and properties to support UI Automation client access to a span of continuous text in a text container that implements ITextProvider.

ITextRangeProvider Members

AddToSelection Adds to the collection of highlighted text in a text container that supports multiple, disjoint selections.
Clone Returns a new ITextRangeProvider identical to the original ITextRangeProvider and inheriting all properties of the original.
Compare Returns a Boolean value indicating whether the span (the start endpoint to the end endpoint) of a text range is the same as another text range.
CompareEndpoints Returns a value that specifies whether two text ranges have identical endpoints.
ExpandToEnclosingUnit Expands the text range to the specified text unit.
FindAttribute Returns a text range subset that has the specified text attribute value.
FindText Returns a text range subset that contains the specified text.
GetAttributeValue Retrieves the value of the specified text attribute across the text range.
GetBoundingRectangles Retrieves a collection of bounding rectangles for each fully or partially visible line of text in a text range.
GetChildren Retrieves a collection of all embedded objects that fall within the text range.
GetEnclosingElement Returns the innermost control that encloses the text range.
GetText Retrieves the plain text of the range.
Move Moves the text range the specified number of text units.
MoveEndpointByRange Moves one endpoint of a text range to the specified endpoint of a second text range.
MoveEndpointByUnit Moves one endpoint of the text range the specified number of TextUnits within the document range.
RemoveFromSelection Removes a highlighted section of text, corresponding to the caller's TextPatternRangeEndpoint_Start and TextPatternRangeEndpoint_End endpoints, from the collection of highlighted text in a text container that supports multiple, disjoint selections.
ScrollIntoView Causes the text control to scroll vertically until the text range is visible in the viewport.
Select Highlights text in the text control corresponding to the text range start and end endpoints.

Remarks

A range can represent an insertion point, a portion of text, or all of the text in a container.

Interface Information

Inherits from IUnknown
Header and IDL files uiautomation.h, uiautomationcore.idl
Minimum operating systems Windows XP

See Also

UI Automation Providers Overview, ITextProvider