IUIAutomationTextRange::MoveEndpointByRange method (uiautomationclient.h)

Article
02/22/2024

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

Syntax

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

Parameters

[in] srcEndPoint

Type: TextPatternRangeEndpoint

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

[in] range

Type: IUIAutomationTextRange*

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

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