IUIAutomationTextRange::MoveEndpointByRange method

Moves one endpoint of the current text range to the specified endpoint of a second text range.

Syntax

HRESULT MoveEndpointByRange(
  TextPatternRangeEndpoint srcEndPoint    ,
  IUIAutomationTextRange                  *range,
  TextPatternRangeEndpoint targetEndPoint 
);

Parameters

arg1

Type: TextPatternRangeEndpoint

An endpoint (either start or end) of the current text range. This is the endpoint to be moved.

range

Type: IUIAutomationTextRange*

A second text range from the same text provider as the current text range.

arg3

Type: TextPatternRangeEndpoint

An endpoint (either start or end) of the second text range. The srcEndPoint of the current text range is moved to this endpoint.

Return Value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If the endpoint being moved crosses the other endpoint of the same text range, that other endpoint is moved also, resulting in a degenerate (empty) range and ensuring the correct ordering of the endpoints (that is, the start is always less than or equal to the end).

Requirements

   
Minimum supported client Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista, Windows XP with SP3 and Platform Update for Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008, Windows Server 2003 with SP2 and Platform Update for Windows Server 2008 [desktop apps only]
Target Platform Windows
Header uiautomationclient.h (include UIAutomation.h)

See Also

IUIAutomationTextRange

UI Automation Support for Textual Content