IUIAutomationTextPattern::GetSelection メソッド (uiautomationclient.h)

テキストベースのコントロールで現在選択されているテキストを表すテキスト範囲のコレクションを取得します。

構文

HRESULT GetSelection(
  [out, retval] IUIAutomationTextRangeArray **ranges
);

[out, retval] ranges

テキスト範囲のコレクションへのポインターを受け取ります。

種類: HRESULT

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

コントロールが連続しない複数のテキスト範囲の選択をサポートしている場合、 range コレクションは選択したスパンごとに 1 つのテキスト範囲を受け取ります。

コントロールに選択したテキストのスパンが 1 つだけ含まれている場合、範囲コレクションは 1 つのテキスト範囲を受け取ります。

コントロールにテキスト挿入ポイントが含まれているが、テキストが選択されていない場合、 ranges コレクションはテキスト挿入ポイントの位置で縮退した (空の) テキスト範囲を受け取ります。

コントロールにテキスト挿入ポイントが含まれていないか、テキストの選択がサポートされていない場合、範囲は NULL に設定されます。

コントロールがテキストの選択をサポートしているかどうかをテストするには、IUIAutomationTextPattern::SupportedTextSelection プロパティを使用します。

要件	値
サポートされている最小のクライアント	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 を含む)