Freigeben über


Schaltflächensteuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung des Button-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

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 Button-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Schaltflächensteuerelemente, bei denen das Ui-Framework/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 den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
  • Taste
    • Bild (beliebige Anzahl)
    • Text (beliebige Anzahl)
  • Taste

 

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AcceleratorKeyPropertyId Siehe Hinweise. Ein Schaltflächensteuerelement unterstützt in der Regel eine Beschleunigungstaste, damit der Endbenutzer die durch die Schaltfläche dargestellte Aktion schnell über die Tastatur ausführen kann.
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht 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 umgebenden Rechtecks geklickt werden kann, und das Element spezielle Treffertests durchführt, überschreiben Sie es, und stellen Sie 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 derselbe Informationstyp, der über eine QuickInfo angezeigt wird.
UIA_IsContentElementPropertyId TRUE Das Schaltflächensteuerelement muss immer Inhalt sein.
UIA_IsControlElementPropertyId TRUE Das Schaltflächensteuerelement 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 Steuerelementtyp Button entspricht. Der Standardwert ist "button" für en-US oder English (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Schaltflächensteuerelements ist der Text, der zum Bezeichnen verwendet wird. Wenn ein Bild zum Beschriften einer Schaltfläche verwendet wird, muss für die Name-Eigenschaft der Schaltfläche alternativer Text angegeben werden.

 

Erforderliche Steuerelementmuster

In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von allen Button-Steuerelementen 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 Steuerelementmuster ExpandCollapse anstelle des Steuerelementmusters Invoke oder Umschalten unterstützen. Das ExpandCollapse-Steuerelementmuster kann zum Öffnen oder Schließen eines Menüs oder einer anderen Dem Schaltflächenelement zugeordneten Unterstruktur verwendet werden.
IInvokeProvider Siehe Hinweise. Alle Schaltflächen sollten das Steuerelementmuster Invokeoder das Umschaltsteuerelementmuster unterstützen, aber nicht beides. Das Steuerelementmuster Invoke 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 Steuerelementmuster Invokeoder das Umschaltsteuerelementmuster unterstützen, aber nicht beides. Das Umschaltsteuerelementmuster muss unterstützt werden, wenn die Schaltfläche eine Reihe von bis zu drei Zuständen durchlaufen 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 Ereignisse aufgeführt, die Schaltflächensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_Invoke_InvokedEventId Wenn das Steuerelement das Invoke-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_NamePropertyId Eigenschaft geändertes Ereignis.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Umschalter-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung