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

各テキスト範囲が表示されているテキストの連続したスパンを表すテキスト ベースのコントロールから、結合されていないテキスト範囲の配列を取得します。

構文

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

パラメーター

[out, retval] ranges

型: IUIAutomationTextRangeArray**

テキスト ベースのコントロール内の表示可能なテキスト範囲のコレクションへのポインターを受け取ります。

戻り値

型: HRESULT

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

注釈

表示されているテキストが連続する 1 つのテキスト範囲で構成されている場合、 ranges 配列には、表示されているすべてのテキストを表す 1 つのテキスト範囲が含まれます。

表示されているテキストが複数の非結合のテキスト範囲で構成されている場合、 ranges 配列には、最初の表示スパンから始まり、最後に表示されるスパンで終わる、表示範囲ごとに 1 つのテキスト範囲が含まれます。 テキスト ベースのコントロールの内容が、重複するウィンドウやその他のオブジェクトによって部分的に隠れている場合、または複数のページまたは列を持つテキスト ベースのコントロールに、部分的にスクロールされたビュー外のコンテンツがある場合に、表示されるテキストの不整合が発生する可能性があります。

IUIAutomationTextPattern::GetVisibleRanges は、テキストが表示されていない場合、すべてのテキストが表示されない場合、またはテキスト ベースのコントロールにテキストが含まれない場合に、縮退した (空の) テキスト範囲を取得します。

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、WINDOWS XP SP3 と 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 を含む)

こちらもご覧ください

IUIAutomationTextPattern

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