Share via

StatusBar-Steuerelementtyp

  • Artikel

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

Ein StatusBar-Steuerelement zeigt Informationen zu einem Objekt an, das in einem Fenster einer Anwendung angezeigt wird, zur Komponente des Objekts oder Kontextinformationen, die sich auf die Operation dieses Objekts in Ihrer Anwendung beziehen.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den StatusBar-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle status-Balkensteuerelemente, 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 der Struktur

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

Steuerelementansicht Inhaltsansicht
  • StatusBar
    • Bearbeiten (beliebige Anzahl)
    • ProgressBar (0 oder viele)
    • Bild (0 oder viele)
    • Schaltfläche (0 oder viele)
  • StatusBar
    • Bearbeiten (beliebige Anzahl)
    • ProgressBar (0 oder viele)
    • Bild (0 oder viele)
    • Schaltfläche (0 oder viele)

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für die status-Balkensteuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
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 umschließende Rechteck einer Statusleiste muss alle darin enthaltenen Steuerelemente umfassen.
UIA_ClickablePointPropertyId Siehe Hinweise. Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn innerhalb des begrenzungsfähigen Rechtecks Bereiche vorhanden sind, die nicht geklickt werden können, und das Element spezielle Treffertests durchführt, überschreiben Sie dies, und geben Sie einen anklickbaren Punkt an.
UIA_ControlTypePropertyId StatusBar
UIA_IsContentElementPropertyId TRUE Das status-Balkensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE Das status-Balkensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId Depends (Abhängig) Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_IsOffscreenPropertyId Depends (Abhängig) Wenn ein status-Balkensteuerelement derzeit nicht sichtbar ist, gibt es true für diese Eigenschaft zurück.
UIA_LabeledByPropertyId NULL Das status-Balkensteuerelement hat in der Regel keine Bezeichnung.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem StatusBar-Steuerelementtyp entspricht. Der Standardwert ist "status bar" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Das StatusBar-Steuerelement muss nur dann einen Namen haben, wenn in einer Anwendung mehrere Statusleisten verwendet werden. In diesem Fall unterscheiden Sie die einzelnen Balken mit Namen wie "Internetstatus" oder "Anwendungsstatus".
UIA_OrientationPropertyId Depends (Abhängig) Ein Wert, der die Ausrichtung des Steuerelements angibt: horizontal oder vertikal.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die für status-Balkensteuerelemente unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster Support Hinweise
IGridProvider Optional Statusleistensteuerelemente sollten das Grid-Steuerelementmuster unterstützen, sodass einzelne Teile überwacht und für Informationen leicht referenziert werden können.

 

Erforderliche Ereignisse

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

Ereignis der Benutzeroberflächenautomatisierung Hinweise
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
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_StructureChangedEventId

 

Bemerkungen

Es wird empfohlen, Bearbeitungssteuerelemente als untergeordnete Rasterelemente in einer status leiste zu verwenden. Die Verwendung von Bearbeitungssteuerelementen vereinfacht das Zuordnen des Zwecks des status Felds mit seinem Wert mithilfe der Elementname- und Werteigenschaft. Da Textsteuerelemente das Wert-Steuerelementmuster nicht unterstützen sollten, sollten sie nicht als untergeordnete Rasterelemente verwendet werden.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung