TextChild コントロール パターン
プロパティとメソッドに関する情報など、ITextChildProvider実装するためのガイドラインと規則について説明します。 TextChild コントロール パターンは、Text コントロール パターンをサポートする要素の最も近い先祖にアクセスするために使用されます。
たとえば、次の図に示すように、文書内のテキストに埋め込み画像とハイパーリンクが含まれているとします。
埋め込み画像とハイパーリンクスクリーン ショット
Microsoft UI オートメーション ツールを使用して、このドキュメント コンテンツの UI オートメーション ツリーを調べると、画像を表す 1 つの子要素とハイパーリンクを表す別の子要素を含むドキュメント要素が表示されることがあります。 例えば：
サンプル ui オートメーション要素ツリースクリーン ショット
通常、前の例のドキュメント要素は、Text コントロール パターンをサポートしていますが、ドキュメント要素の 2 つの子はサポートしていません。 UI オートメーション クライアント アプリケーションがイメージ要素またはハイパーリンク要素への参照を持っている場合、クライアントは、TextChild コントロール パターンを、含まれているドキュメント要素によって公開される Textcontrol パターンにアクセスするための便利な方法として使用できます。
実装のガイドラインと規則
ITextChildProvider インターフェイスを実装する場合は、次のガイドラインと規則に注意してください。
- ITextChildProvider::TextContainer プロパティは、先祖チェーンの上位の要素が ITextProvider もサポートしているかどうかに関係なく、ITextProviderインターフェイスサポートする最も近い先祖要素を指定する必要があります。
- 要素は、ITextProvider と ITextChildProvider** インターフェイスの両方をサポートしないでください。
- ITextChildProvider実装する要素は、ITextProvider実装する要素の子 (子孫) である必要があります。 この要素は、Text コントロール パターンも実装する必要はありません。
- ITextChildProvider::TextRange プロパティは、ITextProvider::RangeFromChild 関数が、囲まれた子要素としてテキスト子要素と共に呼び出されたときに、含まれるテキスト プロバイダー要素が返すテキスト範囲と同じテキスト範囲を指定する必要があります。
ITextChildProvider 必須メンバー
これらのプロパティとメソッドは、ITextChildProvider インターフェイスを実装するために必要です。
| 必須メンバー | メンバーの種類 | 筆記 |
|---|---|---|
| TextContainerの | 財産 | 何一つ |
| TextRange | 財産 | 何一つ |
このコントロール パターンには、関連付けられたメソッドやイベントはありません。
関連トピック
概念