言語

ITextProvider インターフェイス

定義

名前空間:
Microsoft.UI.Xaml.Automation.Provider
編集

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

public interface class ITextProvider
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(937942246, 65146, 22183, 164, 122, 148, 98, 135, 44, 103, 239)]
struct ITextProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(937942246, 65146, 22183, 164, 122, 148, 98, 135, 44, 103, 239)]
public interface ITextProvider
Public Interface ITextProvider
派生
属性
ContractVersionAttribute GuidAttribute

注釈

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

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

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

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

プロパティ

名前 説明
DocumentRange

文書のメイン テキストを囲むテキスト範囲を取得します。
SupportedTextSelection

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

メソッド

名前 説明
GetSelection()

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

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

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

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

適用対象

こちらもご覧ください