IUIAutomationTextPattern::GetSelection メソッド (uiautomationclient.h)
テキスト ベースのコントロールで現在選択されているテキストを表すテキスト範囲のコレクションを取得します。
構文
HRESULT GetSelection(
[out, retval] IUIAutomationTextRangeArray **ranges
);
パラメーター
[out, retval] ranges
種類: IUIAutomationTextRangeArray**
テキスト範囲のコレクションへのポインターを受け取ります。
戻り値
種類: 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 を含む) |