ITextProvider インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
テキストを含むコントロールへの 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 ITextProviderPublic Interface ITextProvider- 派生
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
このパターンの詳細については、「 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) |
画面座標の近くからテキスト範囲を取得します。 |