IUIAutomationTextRange インターフェイス (uiautomationclient.h)
IUIAutomationTextPattern インターフェイスをサポートするコンテナー内の連続テキストのスパンへのアクセスを提供します。 クライアント アプリケーションでは、 IUIAutomationTextRange インターフェイスを使用して、テキスト スパンから埋め込みオブジェクトを選択、比較、および取得できます。 インターフェイスは、2 つのエンドポイントを使用して、テキストスパンの開始位置と終了位置を区切ります。 テキストの不整合スパンは、 IUIAutomationTextRangeArray インターフェイスによって表されます。
継承
IUIAutomationTextRange インターフェイスは、IUnknown インターフェイスから継承します。 IUIAutomationTextRange には、次の種類のメンバーもあります。
メソッド
IUIAutomationTextRange インターフェイスには、これらのメソッドがあります。
| IUIAutomationTextRange::AddToSelection 選択したテキストの複数の不整合スパンをサポートするコントロールで、選択したテキスト範囲のコレクションにテキスト範囲を追加します。 (IUIAutomationTextRange.AddToSelection) |
| IUIAutomationTextRange::Clone 元の プロパティと同じ新しい IUIAutomationTextRange を取得し、元のプロパティをすべて継承します。 |
| IUIAutomationTextRange::Compare このテキスト範囲に別のテキスト範囲と同じエンドポイントがあるかどうかを示す値を取得します。 (IUIAutomationTextRange.Compare) |
| IUIAutomationTextRange::CompareEndpoints このテキスト範囲の開始エンドポイントと終了エンドポイントが、別のテキスト範囲の開始エンドポイントまたは終了エンドポイントと同じかどうかを指定する値を取得します。 |
| IUIAutomationTextRange::ExpandToEnclosingUnit 指定したテキスト単位でテキスト範囲を正規化します。 指定した単位より小さい場合は範囲が拡張され、指定した単位より長い場合は短縮されます。 (IUIAutomationTextRange.ExpandToEnclosingUnit) |
| IUIAutomationTextRange::FindAttribute 指定したテキスト属性値を持つテキスト範囲サブセットを取得します。 |
| IUIAutomationTextRange::FindText 指定したテキストを含むテキスト範囲サブセットを取得します。 |
| IUIAutomationTextRange::GetAttributeValue 指定したテキスト属性の値をテキスト範囲全体で取得します。 |
| IUIAutomationTextRange::GetBoundingRectangles テキスト範囲内のテキストの表示されている各行 (全体または一部) に外接する四角形のコレクションを取得します。 (IUIAutomationTextRange.GetBoundingRectangles) |
| IUIAutomationTextRange::GetChildren テキスト範囲内にあるすべての埋め込みオブジェクトのコレクションを取得します。 (IUIAutomationTextRange.GetChildren) |
| IUIAutomationTextRange::GetEnclosingElement テキスト範囲を囲む最も内側の UI オートメーション要素を返します。 |
| IUIAutomationTextRange::GetText テキスト範囲のプレーンテキストを返します。 |
| IUIAutomationTextRange::Move テキスト範囲を、指定した数のテキスト単位で前後に移動します。 |
| IUIAutomationTextRange::MoveEndpointByRange 現在のテキスト範囲の 1 つのエンドポイントを、2 番目のテキスト範囲の指定されたエンドポイントに移動します。 (IUIAutomationTextRange.MoveEndpointByRange) |
| IUIAutomationTextRange::MoveEndpointByUnit テキスト範囲の 1 つのエンドポイントを、指定されたテキスト単位数の分、ドキュメントの範囲内で移動します。 |
| IUIAutomationTextRange::RemoveFromSelection 複数の非結合選択をサポートするテキスト コンテナー内の選択されたテキストの既存のコレクションからテキスト範囲を削除します。 |
| IUIAutomationTextRange::ScrollIntoView テキスト範囲がビューポートに表示されるまで、テキスト コントロールをスクロールさせます。 |
| IUIAutomationTextRange::Select このテキスト範囲に対応するテキストの範囲を選択し、以前の選択範囲を削除します。 (IUIAutomationTextRange.Select) |
要件
| サポートされている最小のクライアント | 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 を含む) |