ITextRangeProvider::MoveEndpointByRange method (uiautomationcore.h)

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

Syntax

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

Parameters

[in] endpoint

Type: TextPatternRangeEndpoint

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

[in] targetRange

Type: ITextRangeProvider*

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

[in] targetEndpoint

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

Requirement Value
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