Formatvorlagen-Steuerelementmuster
Beschreibt Richtlinien und Konventionen für die Implementierung von IStylesProvider-, einschließlich Informationen zu Eigenschaften und Methoden. Das Formatvorlagen Steuerelementmusters wird verwendet, um ein UI-Element zu beschreiben, das eine bestimmte Formatvorlage, Füllfarbe, Füllmuster oder Form aufweist.
Das Formatvorlagen Steuerelementmusters ist besonders nützlich, um Elemente in einem Dokument zu beschreiben, die häufig solche Formatvorlagen aufweisen. Stile enthalten in der Regel Informationen, die für Kunden mit Behinderungen nützlich sind; Beispielsweise kann eine Formatvorlage eine bestimmte Zeichenfolge als Titel eines Dokuments oder ein bestimmtes Flussdiagrammobjekt als Raute oder kreisweise beschreiben. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.
Dieses Thema enthält die folgenden Abschnitte.
- Implementierungsrichtlinien und -konventionen
- Erforderliche Member für IStylesProvider-
- Verwandte Themen
Implementierungsrichtlinien und -konventionen
Beachten Sie bei der Implementierung des Formatvorlagen Steuerelementmusters die folgenden Richtlinien und Konventionen:
- Die Headerdatei "UIAutomationClient.h" definiert einen Satz benannter Konstantenwerte, die verwendet werden, um mehrere gängige Formatvorlagen zu identifizieren. Weitere Informationen finden Sie unter Formatvorlagenbezeichner.
- Wenn Sie StyleId_Customverwenden, müssen Sie die eigenschaft IStylesProvider::StyleName implementieren, damit Clients den Namen der Formatvorlage ermitteln können. Sie müssen die StyleName-Eigenschaft für eine Standardformatvorlage nicht implementieren, da die Microsoft-Benutzeroberflächenautomatisierung einen Standardnamen bereitstellt, sie aber implementieren können, wenn Sie den Standardnamen überschreiben müssen.
- Die anderen Eigenschaften im Formatvorlagen Musters sind optional; der Anbieter kann UIA_E_NOTSUPPORTED für eine Eigenschaft zurückgeben, die nicht unterstützt wird.
- Formatvorlagen in einem Textbereich können durch die folgenden Textattribute dargestellt werden:
- Wenn sie auf eine Anforderung für die StyleId Textattribute reagieren, sollte der Textbereich einen der formatvorlagenbezeichner zurückgeben, die in Format-IDsbeschrieben sind.
- Wenn StyleId_Custom verwendet wird, sollte der Textbereich einen Zeichenfolgenwert für das StyleName Textattribute zurückgeben, damit Clients den Formatvorlagennamen ermitteln können.
- Ein Textbereich mit mehreren Formatvorlagen, z. B. Überschrift und Normaltext, sollte die spezielle Ui-Automatisierung ReservedMixedAttributeValue Eigenschaft sowohl für die StyleId- als auch für StyleName- Eigenschaften zurückgeben. Ein Client, der diese Antwort empfängt, kann den Textbereich unterteilen, um zu ermitteln, wo die Formatvorlagen beginnen und enden.
- Anwendungen können eine Vielzahl von Formatvorlagen verwenden, um Objekte zu beschreiben, aber die Benutzeroberflächenautomatisierung stellt nur die am häufigsten verwendeten dar. Um zusätzliche Formatattribute wie Rahmenfarbe darzustellen, kann ein Anbieter eine Liste mit zusätzlichen Attributen in der ExtendedProperties-eigenschaft-Eigenschaft zurückgeben. Dies ist im Grunde ein Eigenschaftenbehälter mit einer Reihe erweiterter Eigenschaften, z. B. "BorderColor=0xFF0000; BorderStyle=dotted". Die Werte erweiterter Eigenschaften können anwendungsspezifisch sein.
Erforderliche Elemente für IStylesProvider-
Die folgenden Eigenschaften sind für die Implementierung der IStylesProvider Schnittstelle erforderlich.
Erforderliche Mitglieder | Elementtyp | Notizen |
---|---|---|
ExtendedProperties- | Eigentum | Nichts |
FillColor- | Eigentum | Nichts |
FillPatternColor- | Eigentum | Nichts |
FillPatternStyle- | Eigentum | Nichts |
Shape- | Eigentum | Nichts |
StyleId- | Eigentum | Nichts |
StyleName- | Eigentum | Nichts |
Dieses Steuerelementmuster weist keine zugeordneten Methoden oder Ereignisse auf.
Verwandte Themen
-
Steuerelementtypen und deren unterstützte Steuerelementmuster
-
Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung
-
übersicht über Benutzeroberflächenautomatisierungsstruktur