Freigeben über

Schaltflächen-Steuerelementtyp

  • Artikel

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

Eine Schaltfläche ist ein Objekt, mit dem ein Benutzer interagiert, um eine Aktion auszuführen, z. B. die Schaltflächen "OK" und "Abbrechen" in einem Dialogfeld. Das Schaltflächensteuerelement ist ein einfaches Steuerelement, das verfügbar gemacht werden kann, da es einem einzelnen Befehl zugeordnet ist, den der Benutzer abschließen möchte.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den steuerelementtyp Button definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Schaltflächensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Schaltflächensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Knopf
    • Bild (0 oder mehr)
    • Text (0 oder mehr)
  • Knopf

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung 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 Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AcceleratorKeyPropertyId Siehe Hinweise. Ein Schaltflächensteuerelement unterstützt in der Regel eine Tastenkombination, damit der Endbenutzer schnell die durch die Schaltfläche dargestellte Aktion über die Tastatur ausführen kann.
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben 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 ist. Dies ist in der Regel derselbe Informationstyp, der über eine QuickInfo dargestellt wird.
UIA_IsContentElementPropertyId STIMMT Das Schaltflächensteuerelement muss immer Inhalt sein.
UIA_IsControlElementPropertyId STIMMT 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ächensteuerelemente werden von ihren Inhalten selbst beschriftet.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem steuerelementtyp Button 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 zum Bezeichnen des Steuerelements verwendet wird. 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 Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Schaltflächensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Control Pattern/Pattern-Eigenschaft Support/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 Umschalten 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 Aufrufen Steuerelementmuster oder das Umschalten Steuerelementmusters unterstützen, jedoch nicht beides. Das Aufruf-Steuerelementmuster muss unterstützt werden, wenn die Schaltfläche einen Befehl auf Anforderung des Benutzers ausführt. Dieser Befehl ordnet einem einzelnen Vorgang wie "Ausschneiden", "Kopieren", "Einfügen" oder "Löschen" zu.
IToggleProvider- Siehe Hinweise. Alle Schaltflächen sollten das Aufrufen Steuerelementmuster oder das Umschalten Steuerelementmusters unterstützen, jedoch nicht beides. Das Umschaltsteuerelementmuster muss unterstützt werden, wenn die Schaltfläche eine Reihe von bis zu drei Zuständen durchlaufen kann. Dies wird in der Regel als Ein/Aus-Schalter für bestimmte Features angesehen.

 

Erforderliche Ereignisse

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

Benutzeroberflächenautomatisierungs-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 dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. 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 Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen.

 

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung