TextChild コントロール パターン

プロパティとメソッドに関する情報など、 ITextChildProvider を実装するためのガイドラインと規則について説明します。 TextChild コントロール パターンは、Text コントロール パターンをサポートする要素の最も近い先祖にアクセスするために使用されます。

たとえば、次の図に示すように、文書内のテキストに埋め込み画像とハイパーリンクが含まれているとします。

Microsoft UI オートメーション ツールを使用してこのドキュメント コンテンツのUI オートメーション ツリーを調べると、画像を表す 1 つの子要素とハイパーリンクを表す別の子要素を含むドキュメント要素が表示されることがあります。 次に例を示します。

通常、前の例の document 要素は Text コントロール パターンをサポートしていますが、ドキュメント要素の 2 つの子はサポートしていません。 UI オートメーションクライアント アプリケーションが image 要素または hyperlink 要素への参照を持っている場合、クライアントは TextChild コントロール パターンを、含むドキュメント要素によって公開される Textcontrol パターンにアクセスするための便利な方法として使用できます。

実装のガイドラインと規則

ITextChildProvider インターフェイスを実装する場合は、次のガイドラインと規則に注意してください。

• ITextChildProvider::TextContainer プロパティは、先祖チェーンの上位の要素でも ITextProvider をサポートするかどうかに関係なく、ITextProvider インターフェイスをサポートする最も近い先祖要素を指定する必要があります。
• 要素は、ITextProvider インターフェイスと ITextChildProvider ** インターフェイスの両方 を サポートしないでください。
• ITextChildProvider を実装する要素は、ITextProvider を実装する要素の子 (子孫) である必要があります。 この要素も Text コントロール パターンを実装する必要はありません。
• ITextChildProvider::TextRange プロパティは、囲まれた子要素としてテキスト子要素を使用して ITextProvider::RangeFromChild 関数が呼び出されたときに、含むテキスト プロバイダー要素が返すテキスト範囲と同じテキスト範囲を指定する必要があります。

ITextChildProvider の必須メンバー

これらのプロパティとメソッドは、 ITextChildProvider インターフェイスを実装するために必要です。

このコントロール パターンに関連するメソッドまたはイベントはありません。

関連トピック

概念

• コントロール型とそのサポートされているコントロール パターン
• UI オートメーション コントロール パターンの概要
• UI オートメーション ツリーの概要