IUIAutomationTextPattern2::GetCaretRange メソッド (uiautomationclient.h)
テキスト ベースのコントロールに属するキャレットの位置にある長さ 0 のテキスト範囲を取得します。
構文
HRESULT GetCaretRange(
[out, retval] BOOL *isActive,
[out, retval] IUIAutomationTextRange **range
);
パラメーター
[out, retval] isActive
種類: BOOL*
キャ レットを含むテキスト ベースのコントロールにキーボード フォーカスがある場合は TRUE、それ以外の場合 は FALSE。
[out, retval] range
種類: IUIAutomationTextRange**
テキスト ベースのコントロールに属するキャレットの現在の位置を表すテキスト範囲を受け取ります。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
isActive パラメーターが FALSE の場合、テキスト ベースのコントロールに属するキャレットがシステム キャレットと同じ場所にない可能性があります。
このメソッドは、クライアントがテキスト ベースのコントロールに属するキャレットの外接する四角形を検索したり、キャレットの近くのテキストを検索したりするために使用できるテキスト範囲を取得します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | uiautomationclient.h (UIAutomation.h を含む) |