Share via


ITextProvider インターフェイス

定義

テキストを含むコントロールへの Microsoft UI オートメーション クライアント アクセスをサポートするメソッドとプロパティを公開します。 オートメーション クライアントが GetPattern 呼び出しと PatternInterface.Text を使用して要求する機能をサポートするために、このインターフェイスを実装します。

public interface class ITextProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3680222367, 18439, 20266, 134, 120, 27, 19, 243, 198, 14, 34)]
struct ITextProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(3680222367, 18439, 20266, 134, 120, 27, 19, 243, 198, 14, 34)]
public interface ITextProvider
Public Interface ITextProvider
派生
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

このパターンの詳細については、「 Text および TextRange コントロール パターン」を参照してください。

ITextProvider、ITextProvider2および ITextRangeProvider は、インターフェイスのこの定義を使用して既存のWindows ランタイムオートメーション ピアによって実装されません。 TextBoxRichTextBlock などのテキスト コントロールWindows ランタイムサポートされているテキスト モデルでは、これらのパターンの一部が実装されますが、API サーフェイスのWindows ランタイム定義には表示されないネイティブ レベルで実装されます。 詳細については、さまざまなWindows ランタイム テキスト コントロールのピア クラスを参照してください。

Windows ランタイム API 内の Microsoft UI オートメーション インターフェイスは、カスタム コントロール作成者がカスタム コントロールのオートメーション パターンをサポートできるように存在し、コントロール ロジックやその他のオートメーション サポートを定義するために使用するのと同じWindows ランタイムマネージド API または C++ API を使用して自動化サポートを実装できるようにします。

ITextProvider パターンには、Windows ランタイム プロパティ識別子クラスがありません。

プロパティ

DocumentRange

ドキュメントのメイン テキストを囲むテキスト範囲を取得します。

SupportedTextSelection

テキスト プロバイダーが選択範囲をサポートしているかどうかを示す値を取得します。サポートされている選択範囲の種類を指定します。

メソッド

GetSelection()

現在のテキストの選択範囲または選択範囲に関連付けられている結合されていないテキスト範囲のコレクションを取得します。

GetVisibleRanges()

テキスト コンテナーから結合されていないテキスト範囲の配列を取得します。 各テキスト範囲は、最初の部分的に表示される行で始まり、最後に部分的に表示される行で終わります。

RangeFromChild(IRawElementProviderSimple)

画像、ハイパーリンク、その他の埋め込みオブジェクトなどの子要素を囲むテキスト範囲を取得します。

RangeFromPoint(Point)

画面座標の近くからテキスト範囲を取得します。

適用対象

こちらもご覧ください