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