Freigeben über


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

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.

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung

übersicht über Benutzeroberflächenautomatisierungsstruktur