ITextRangeProvider::MoveEndpointByRange method

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

Syntax

HRESULT MoveEndpointByRange(
  TextPatternRangeEndpoint endpoint       ,
  ITextRangeProvider                      *targetRange,
  TextPatternRangeEndpoint targetEndpoint 
);

Parameters

arg1

Type: TextPatternRangeEndpoint

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

targetRange

Type: ITextRangeProvider*

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 endpoint 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 XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header uiautomationcore.h (include UIAutomation.h)

See Also

Conceptual

ITextProvider

ITextRangeProvider

Reference

UI Automation Providers Overview