TextChild-Steuerelementmuster

Enthält Richtlinien und Konventionen für die Implementierung von ITextChildProvider-, einschließlich Informationen zu Eigenschaften und Methoden. Das TextChild Steuerelementmusters wird verwendet, um auf das nächste Vorgängerelement eines Elements zuzugreifen, das das Text Steuerelementmusters unterstützt.

Angenommen, Text in einem Dokument enthält ein eingebettetes Bild und einen Link, wie in der folgenden Abbildung dargestellt.

Wenn Sie die Benutzeroberflächenautomatisierungstools verwenden, um die Benutzeroberflächenautomatisierungsstruktur für diesen Dokumentinhalt zu untersuchen, wird möglicherweise ein Dokumentelement mit einem untergeordneten Element angezeigt, das das Bild darstellt, und ein anderes untergeordnetes Element, das den Link darstellt. Zum Beispiel:

In der Regel unterstützt das Dokumentelement im vorherigen Beispiel das Text Steuerelementmusters, die beiden untergeordneten Elemente des Dokumentelements jedoch nicht. Wenn eine Benutzeroberflächenautomatisierungs-Clientanwendung über einen Verweis auf das Bildelement oder Hyperlinkelement verfügt, kann der Client das TextChild- Steuerelementmuster als bequeme Möglichkeit verwenden, um auf das Textcontrol-Muster zuzugreifen, das vom enthaltenden Dokumentelement verfügbar gemacht wird.

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung der ITextChildProvider Schnittstelle die folgenden Richtlinien und Konventionen:

• Die ITextChildProvider::TextContainer--Eigenschaft sollte das nächste Vorgängerelement angeben, das ITextProvider Schnittstelle unterstützt, unabhängig davon, ob Elemente in der Übergeordneten Kette auch ITextProvider-unterstützen.
• Ein Element sollte nicht sowohl dieITextProvider- als auch die ITextChildProvider** Schnittstelle unterstützen.
• Ein Element, das ITextChildProvider implementiert, muss ein untergeordnetes oder untergeordnetes Element eines Elements sein, das ITextProvider-implementiert. Es ist nicht erforderlich, dass dieses Element auch das Text-Steuerelementmusterimplementiert.
• Die ITextChildProvider::TextRange-Eigenschaft sollte denselben Textbereich angeben, den das enthaltende Textanbieterelement zurückgibt, wenn die ITextProvider::RangeFromChild-Funktion mit dem untergeordneten Textelement als eingeschlossenes untergeordnetes Element aufgerufen wird.

Erforderliche Elemente für ITextChildProvider-

Diese Eigenschaften und Methoden sind für die Implementierung der ITextChildProvider Schnittstelle erforderlich.

Dieses Steuerelementmuster weist keine zugeordneten Methoden oder Ereignisse auf.

Verwandte Themen

Konzeptionelle

• Steuerelementtypen und deren unterstützte Steuerelementmuster
• Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung
• übersicht über Benutzeroberflächenautomatisierungsstruktur