Freigeben über

Formatvorlagen-Steuerelementmuster

  • Artikel

Beschreibt Richtlinien und Konventionen für die Implementierung von IStylesProvider, einschließlich Informationen zu Eigenschaften und Methoden. Das Stil-Steuerelementmuster wird verwendet, um ein UI-Element zu beschreiben, das eine bestimmte Formatvorlage, Füllfarbe, Füllmuster oder Form aufweist.

Das Formatvorlagen-Steuerelementmuster ist besonders nützlich, um Elemente in einem Dokument zu beschreiben, die häufig über solche Stile verfügen. 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 Diamant oder Kreis beschreiben. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und ihre unterstützten Steuerelementmuster.

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren des Stil-Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Die UiAutomationClient.h-Headerdatei definiert einen Satz benannter Konstantenwerte, die zum Identifizieren mehrerer gängiger Stile verwendet werden. Weitere Informationen finden Sie unter Formatbezeichner.
  • Wenn Sie StyleId_Custom verwenden, müssen Sie die IStylesProvider::StyleName-Eigenschaft implementieren, damit Clients den Namen der Formatvorlage ermitteln können. Sie müssen die StyleName-Eigenschaft für eine Standardformatvorlage nicht implementieren, da Microsoft Benutzeroberflächenautomatisierung einen Standardnamen bereitstellt, aber Sie können ihn implementieren, wenn Sie den Standardnamen überschreiben müssen.
  • Die anderen Eigenschaften im Formatvorlagenmuster 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 das StyleId-Textattribut antworten, sollte der Textbereich einen der in Formatbezeichnern beschriebenen Stilbezeichner zurückgeben.
    • Wenn StyleId_Custom verwendet wird, sollte der Textbereich einen Zeichenfolgenwert für das Textattribut StyleName zurückgeben, damit Clients den Formatvorlagennamen ermitteln können.
    • Ein Textbereich mit mehreren Formatvorlagen, z. B. Überschrift und normaler Text, sollte die spezielle Benutzeroberflächenautomatisierung ReservedMixedAttributeValue-Eigenschaft sowohl für die StyleId- als auch für die StyleName-Eigenschaft 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 Stilen verwenden, um Objekte zu beschreiben, aber Benutzeroberflächenautomatisierung stellt nur die am häufigsten verwendeten Stile dar. Um zusätzliche Formatattribute darzustellen, z. B. Rahmenfarbe, kann ein Anbieter eine Liste mit zusätzlichen Attributen in der ExtendedProperties-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 Member für IStylesProvider

Die folgenden Eigenschaften sind erforderlich, um die IStylesProvider-Schnittstelle zu implementieren.

Erforderliche Member Memberart Hinweise
ExtendedProperties Eigenschaft Keine
Fillcolor Eigenschaft Keine
FillPatternColor Eigenschaft Keine
FillPatternStyle Eigenschaft Keine
Form Eigenschaft Keine
StyleId Eigenschaft Keine
StyleName Eigenschaft Keine

 

Diesem Steuerelementmuster sind keine Methoden oder Ereignisse zugeordnet.

Steuerelementtypen und ihre unterstützten Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur