IUIAutomationTextRange::Move メソッド (uiautomationclient.h)

テキスト範囲を、指定した数のテキスト単位で前後に移動します。

構文

HRESULT Move(
  [in]          TextUnit unit,
  [in]          int      count,
  [out, retval] int      *moved
);

パラメーター

[in] unit

Type: TextUnit

文字、単語、段落など、テキスト単位の種類を指定する値。

[in] count

型: int

移動するテキスト単位の数。 正の値を指定すると、テキスト範囲が前方に移動します。 負の値を指定すると、テキスト範囲が後方に移動します。 ゼロは効果がありません。

[out, retval] moved

型: int*

実際に移動されたテキスト単位の数を受け取ります。 これは、新しいテキスト範囲エンドポイントのいずれかが IUIAutomationTextPattern::D ocumentRange メソッドによって取得されたエンドポイントより大きいか小さい場合に、要求された数より小さくすることができます。 ナビゲーションが逆方向に行われている場合、この値は負の値になる可能性があります。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

IUIAutomationTextRange::Move はテキスト範囲を移動して、テキストの別の部分にまたがります。テキストは何も変更されません。

縮退しない (空でない) テキスト範囲の場合、 IUIAutomationTextRange::Move は次の手順を実行して範囲を正規化して移動します。

  1. テキスト範囲は、開始エンドポイントで縮退 (空) 範囲に折りたたまれます。
  2. 必要に応じて、結果のテキスト範囲は、ドキュメント内の要求されたテキスト単位境界の先頭に後方に移動されます。
  3. テキスト範囲は、要求された数のテキスト単位境界によって文書内で前後に移動されます。
  4. テキスト範囲は、要求された 1 つのテキストユニット境界によって終了エンドポイントを前方に移動することで、縮退状態から拡張されます。
上記の手順のいずれかが失敗した場合、テキスト範囲は変更されません。 テキスト範囲を要求された数のテキスト単位まで移動できないが、テキスト単位の数が少ない場合、テキスト範囲はテキスト単位の数だけ移動され、 移動 するテキスト単位の数に設定されます。

縮退したテキスト範囲の場合、 IUIAutomationTextRange::Move は指定した数のテキスト単位でテキスト挿入ポイントを移動するだけです。

テキスト範囲を移動すると、 IUIAutomationTextRange::Move はテキスト内の埋め込みオブジェクトの境界を無視します。

IUIAutomationTextRange::Move は、非表示のテキストと表示されるテキストの両方を考慮します。

テキスト ベースのコントロールで unit パラメーターで指定されたテキスト単位がサポートされていない場合、 IUIAutomationTextRange::Move は、サポートされている次の大きなテキスト単位に置き換えられます。

テキスト単位のサイズ (最小単位から最大値まで) は次のとおりです。

  • 文字
  • 形式
  • Word
  • 段落
  • Page
  • ドキュメント

単位が の場合の範囲の動作TextUnit::Format

TextUnit::Formatを単位値として、範囲内のテキストの共有テキスト属性 (書式) に基づいて範囲を展開または移動するために、テキスト範囲の境界を配置します。 ただし、テキストの書式設定単位を使用しても、画像やハイパーリンクなど、埋め込みオブジェクトの境界を越えてテキスト範囲を移動または展開することはできません。 詳細については、「テキスト単位のUI オートメーション」または「テキストコンテンツのサポートUI オートメーション」を参照してください。

要件

要件
サポートされている最小のクライアント Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、SP3 を使用した Windows XP、Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、WINDOWS Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー uiautomationclient.h (UIAutomation.h を含む)

こちらもご覧ください

IUIAutomationTextRange

テキスト コンテンツのUI オートメーションサポート