ITextRangeProvider::MoveEndpointByRange method

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

endpoint [in]

Type: TextPatternRangeEndpoint

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

targetRange [in]

Type: ITextRangeProvider*

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

targetEndpoint [in]

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

See also

Reference

ITextProvider

ITextRangeProvider

Conceptual

UI Automation Providers Overview