Stilsteuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung von IStylesProvider,einschließlich Informationen zu Eigenschaften und Methoden. Das Steuerelementmuster Stile wird verwendet, um ein Benutzeroberflächenelement zu beschreiben, das über einen bestimmten Stil, eine bestimmte Füllfarbe, ein bestimmtes Füllmuster oder eine bestimmte Form verfügt.

Das Stilsteuerelementmuster ist besonders nützlich, um Elemente in einem Dokument zu beschreiben, die häufig solche Stile aufweisen. Stile enthalten in der Regel Informationen, die für Kunden mit Behinderungen nützlich sind. Beispielsweise kann ein Stil eine bestimmte Zeichenfolge als Titel eines Dokuments oder ein bestimmtes Flussdiagrammobjekt als Raute oder 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 beim Implementieren des Stilsteuerelementmusters die folgenden Richtlinien und Konventionen:

  • Die Headerdatei UIAutomationClient.h definiert einen Satz benannter konstanter Werte, mit denen mehrere gängige Stile identifiziert werden. Weitere Informationen finden Sie unter Formatbezeichner.
  • Wenn Sie StyleId _ Customverwenden, müssen Sie die IStylesProvider::StyleName-Eigenschaft implementieren, damit Clients den Namen des Stils ermitteln können. Sie müssen die StyleName-Eigenschaft nicht für einen Standardstil implementieren, da Microsoft Benutzeroberflächenautomatisierung einen Standardnamen bereitstellt. Sie können sie jedoch implementieren, wenn Sie den Standardnamen überschreiben müssen.
  • Die anderen Eigenschaften im Stilmuster sind optional. der Anbieter kann UIA _ E _ NOTSUPPORTED für eine Eigenschaft zurückgeben, die nicht unterstützt wird.
  • Stile in einem Textbereich können durch die folgenden Textattribute dargestellt werden:
    • Wenn auf eine Anforderung für das Textattribut StyleId reagiert wird, sollte der Textbereich einen der in Formatbezeichner beschriebenenFormatbezeichner zurückgeben.
    • Wenn StyleId _ Custom verwendet wird, sollte der Textbereich einen Zeichenfolgenwert für das Textattribut StyleName zurückgeben, damit Clients den Stilnamen ermitteln können.
    • Ein Textbereich, der über mehrere Stile verfügt, 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 Stile beginnen und enden.
  • Anwendungen können eine Vielzahl von Stilen verwenden, um Objekte zu beschreiben, aber Benutzeroberflächenautomatisierung stellt nur die gängigsten dar. Um zusätzliche Stilattribute darzustellen, z. B. Rahmenfarbe, 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 Member für IStylesProvider

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

Erforderliche Member Memberart Hinweise
Extendedproperties Eigenschaft Keine
Fillcolor Eigenschaft Keine
FillPatternColor Eigenschaft Keine
FillPatternStyle Eigenschaft Keine
Formen 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