Formatvorlagen-Steuerelementmuster

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

Das Formatvorlagen-Steuerelementmuster eignet sich besonders für die Beschreibung von Elementen in einem Dokument, die häufig über solche Formatvorlagen verfügen. Formatvorlagen tragen 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 einen Kreis beschreiben. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.

Dieses Thema enthält folgende 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 Style Identifiers.
  • 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 nicht für eine Standardformatvorlage implementieren, da Microsoft Benutzeroberflächenautomatisierung einen Standardnamen bereitstellt, sie aber implementieren können, wenn Sie den Standardnamen außer Kraft setzen 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:
  • Anwendungen können eine Vielzahl von Formatvorlagen verwenden, um Objekte zu beschreiben, aber Benutzeroberflächenautomatisierung stellt nur die am häufigsten verwendeten dar. Um zusätzliche Formatattribute wie Rahmenfarbe darzustellen, kann ein Anbieter eine Liste zusätzlicher Attribute 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 Elemente für IStylesProvider

Für die Implementierung der IStylesProvider-Schnittstelle sind die folgenden Eigenschaften erforderlich.

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 deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur