Stile-Steuerelement Muster

Beschreibt Richtlinien und Konventionen für das Implementieren von istylesprovider, einschließlich Informationen zu Eigenschaften und Methoden. Das Stile -Steuerelement Muster wird verwendet, um ein UI-Element zu beschreiben, das einen bestimmten Stil, eine bestimmte Füllfarbe, ein Füllmuster oder eine Form aufweist.

Das Stile -Steuerelement Muster ist besonders nützlich für das Beschreiben von Elementen in einem Dokument, die häufig über solche Stile verfügen. Stile enthalten in der Regel Informationen, die für Kunden mit Behinderungen nützlich sind. ein Stil kann z. b. eine bestimmte Zeichenfolge als Titel eines Dokuments oder ein bestimmtes Flussdiagramm Objekt als Diamant oder Kreis beschreiben. Beispiele für Steuerelemente, die dieses Steuerelement Muster implementieren, finden Sie unter Steuerelement Typen und ihre unterstützten Steuerelement Muster.

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren des Stile -Steuerelement Musters die folgenden Richtlinien und Konventionen:

  • Die UIAutomationClient. h-Header Datei definiert einen Satz benannter konstanter Werte, mit denen verschiedene gängige Stile identifiziert werden. Weitere Informationen finden Sie unter Format Bezeichner.
  • 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 für einen Standardstil nicht implementieren, da die Microsoft-Benutzeroberflächen Automatisierung einen Standardnamen bereitstellt. Sie können Sie jedoch implementieren, wenn Sie den Standardnamen überschreiben müssen.
  • Die anderen Eigenschaften im Stile -Muster 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 Text Attribute dargestellt werden:
    • Wenn Sie auf eine Anforderung für das styleId -Text Attribut reagieren, sollte der Textbereich einen der im StilBezeichner beschriebenen Format Bezeichner zurückgeben.
    • Wenn styleId _ Custom verwendet wird, sollte der Textbereich einen Zeichen folgen Wert für das Attribut " styleName Text" zurückgeben, damit Clients den Format Namen ermitteln können.
    • Ein Textbereich, der über mehrere Stile verfügt, z. b. sowohl Überschrift und normaler Text, sollte die besondere Benutzeroberflächenautomatisierungs- reservedmixedattributevalue -Eigenschaft für die Eigenschaften styleId und styleName 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 die Benutzeroberflächen Automatisierung stellt nur die gängigsten dar. Um zusätzliche Stil Attribute darzustellen, wie z. b. die Rahmenfarbe, kann ein Anbieter eine Liste zusätzlicher Attribute in der ExtendedProperties -Eigenschaft zurückgeben. Dabei handelt es sich im Grunde um einen Eigenschaften Behälter mit einer Reihe erweiterter Eigenschaften, z. b. "BorderColor = 0xFF0000; BorderStyle = gepunktete ". 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.

Steuerelement Typen und ihre unterstützten Steuerelement Muster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur