Schaltflächen-Steuerelementtyp

Dieses Thema enthält Informationen zur Microsoft Benutzeroberflächenautomatisierung-Unterstützung für den Schaltflächen-Steuerelementtyp.

Eine Schaltfläche ist ein Objekt, das ein Benutzer dazu verwendet, eine Aktion auszuführen, z. B. die Schaltflächen OK und Abbrechen in einem Dialogfeld. Das Schaltflächen-Steuerelement ist hinsichtlich des Verfügbarmachens ein einfaches Steuerelement, weil es einem einzelnen Befehl zugeordnet ist, den der Benutzer ausführen möchte.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Schaltflächen-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Schaltflächensteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Schaltflächensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung Struktur.

Steuerelementansicht Inhaltsansicht
  • Schaltfläche
    • Bild (beliebige Anzahl)
    • Text (beliebige Anzahl)
  • Schaltfläche

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für die Steuerelemente, die den Steuerelementtyp Button implementieren (z. B. Schaltflächensteuerelemente), besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA _ AcceleratorKeyPropertyId Siehe Hinweise. Ein Schaltflächensteuerelement unterstützt in der Regel eine Zugriffstaste, damit der Endbenutzer die aktion, die durch die Schaltfläche dargestellt wird, schnell über die Tastatur ausführen kann.
UIA _ AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein.
UIA _ BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA _ ClickablePointPropertyId Siehe Hinweise. Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreibt und stellt einen klickbaren Punkt bereit.
UIA _ ControlTypePropertyId Schaltfläche
UIA _ HelpTextPropertyId Siehe Hinweise. Der Hilfetext sollte angeben, was das Endergebnis der Aktivierung der Schaltfläche sein wird. Dies ist in der Regel die gleiche Art von Informationen, die über eine QuickInfo angezeigt werden.
UIA _ IsContentElementPropertyId TRUE Das Schaltflächensteuerelement muss immer inhalt sein.
UIA _ IsControlElementPropertyId TRUE Das Schaltflächen-Steuerelement muss immer ein -Steuerelement sein.
UIA _ IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA _ LabeledByPropertyId Null Schaltflächen-Steuerelemente werden durch ihren Inhalt selbstbeschriftet.
UIA _ LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Schaltflächen-Steuerelementtyp entspricht. Der Standardwert ist "button" für en-US oder Englisch (USA).
_UIA-NamePropertyId Siehe Hinweise. Der Name des Schaltflächensteuerelements ist der Text, der zur Bezeichnung verwendet wird. Jedes Mal, wenn ein Bild zum Bezeichnen einer Schaltfläche verwendet wird, muss alternativer Text für die Name-Eigenschaft der Schaltfläche angegeben werden.

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Schaltflächensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster/Mustereigenschaft Unterstützung/Wert Notizen
IExpandCollapseProvider Siehe Hinweise. Wenn eine Schaltfläche als untergeordnetes Element einer geteilten Schaltfläche gehostet wird, kann die untergeordnete Schaltfläche das ExpandCollapse-Steuerelementmuster anstelle des Invoke- oder Toggle-Steuerelementmusters unterstützen. Das ExpandCollapse-Steuerelementmuster kann zum Öffnen oder Schließen eines Menüs oder einer anderen Unterstruktur verwendet werden, die dem Schaltflächenelement zugeordnet ist.
IInvokeProvider Siehe Hinweise. Alle Schaltflächen sollten das Invoke-Steuerelementmuster oder das Toggle-Steuerelementmuster unterstützen, jedoch nicht beides. Das Invoke-Steuerelementmuster muss unterstützt werden, wenn die Schaltfläche auf Anforderung des Benutzers einen Befehl ausführt. Dieser Befehl ist einem einzelnen Vorgang zugeordnet, etwa Ausschneiden, Kopieren, Einfügen oder Löschen.
IToggleProvider Siehe Hinweise. Alle Schaltflächen sollten das Invoke-Steuerelementmuster oder das Umschalten-Steuerelementmuster unterstützen, aber nicht beides. Das Umschalten-Steuerelementmuster muss unterstützt werden, wenn die Schaltfläche eine Reihe von bis zu drei Zuzuständen durchzyklen kann. In der Regel ist dies als Ein-/Ausschalter für bestimmte Features zu sehen.

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die Schaltflächensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AutomationFocusChangedEventId
UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis.
UIA _ Invoke _ InvokedEventId Wenn das Steuerelement das Invoke-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsEnabledPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsOffscreenPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ NamePropertyId-Eigenschaftsänderungsereignis.
UIA _ StructureChangedEventId
UIA _ ToggleToggleStatePropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das Umschalten-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung