TextChild-Steuerelementmuster

Führt Richtlinien und Konventionen für die Implementierung von ITextChildProvider ein, einschließlich Informationen zu Eigenschaften und Methoden. Das TextChild-Steuerelementmuster wird verwendet, um auf den nächsten Vorgänger eines Elements zuzugreifen, der das Text-Steuerelementmuster unterstützt.

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

Wenn Sie microsoft Benutzeroberflächenautomatisierung Tools verwenden, um die Benutzeroberflächenautomatisierung-Struktur für diesen Dokumentinhalt zu untersuchen, wird möglicherweise ein Dokumentelement mit einem untergeordneten Element angezeigt, das das Bild darstellt, und einem weiteren untergeordneten Element, das den Link darstellt. Beispiel:

In der Regel unterstützt das document-Element im vorherigen Beispiel das Text-Steuerelementmuster, die beiden untergeordneten Elemente des document-Elements hingegen nicht. Wenn eine Benutzeroberflächenautomatisierung Clientanwendung über einen Verweis auf das Image- oder Linkelement verfügt, kann der Client das TextChild-Steuerelementmuster als bequeme Möglichkeit für den Zugriff auf das Textcontrol-Muster verwenden, das vom enthaltenden Dokumentelement verfügbar gemacht wird.

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren der ITextChildProvider-Schnittstelle die folgenden Richtlinien und Konventionen:

• Die ITextChildProvider::TextContainer-Eigenschaft sollte das nächste übergeordnete Element angeben, das die ITextProvider-Schnittstelle unterstützt, unabhängig davon, ob Elemente höher in der Vorgängerkette 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 Element oder ein Nachfolger eines Elements sein, das ITextProvider implementiert. Es ist nicht erforderlich, dass dieses Element auch das Text-Steuerelementmuster implementiert.
• Die ITextChildProvider::TextRange-Eigenschaft sollte denselben Textbereich angeben, den das enthaltende Textanbieterelement zurückgibt, wenn seine 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.

Erforderliche Member	Memberart	Hinweise
TextContainer	Eigenschaft	Keine
Textbereich	Eigenschaft	Keine

 

Diesem Steuerelementmuster sind keine Methoden oder Ereignisse zugeordnet.

Zugehörige Themen

Konzept

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