ITextRangeProvider::MoveEndpointByRange メソッド (uiautomationcore.h)

現在のテキスト範囲の 1 つのエンドポイントを、2 番目のテキスト範囲の指定されたエンドポイントに移動します。

構文

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

パラメーター

[in] endpoint

型: TextPatternRangeEndpoint

現在のテキスト範囲のエンドポイント (開始または終了)。 これは移動するエンドポイントです。

[in] targetRange

型: ITextRangeProvider*

現在のテキスト範囲と同じテキスト プロバイダーからの 2 番目のテキスト範囲。

[in] targetEndpoint

型: TextPatternRangeEndpoint

2 番目のテキスト範囲のエンドポイント (開始または終了)。 現在のテキスト範囲の エンドポイント がこのエンドポイントに移動されます。

戻り値

型: HRESULT

このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。

備考

移動されるエンドポイントが同じテキスト範囲の他のエンドポイントを越える場合、その他のエンドポイントも移動され、結果として縮退 (空) 範囲になり、エンドポイントの正しい順序が保証されます (つまり、開始は常に終了以下になります)。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー uiautomationcore.h (UIAutomation.h を含む)

関連項目

概念

ITextProvider の

ITextRangeProvider の

リファレンス

UI オートメーション プロバイダーの概要