StatusBar-Steuerelementtyp

Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den StatusBar-Steuerelementtyp.

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 Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den StatusBar-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung gelten für alle Statusleisten-Steuerelemente, bei denen das Benutzeroberflächenframework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Strukturstruktur

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

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 Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für die Statusleisten-Steuerelemente besonders relevant ist. Weitere Informationen zu Eigenschaften Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA _ AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Struktur der Benutzeroberflächenautomatisierung 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 sich Bereiche innerhalb des umgebundenen Rechtecks befinden, auf die nicht geklickt werden kann, und das Element spezielle Treffertests ausführt, überschreiben Sie dies, und stellen Sie einen klickbaren Punkt zur Verfügung.
UIA _ ControlTypePropertyId StatusBar
UIA _ IsContentElementPropertyId TRUE Das Statusleisten-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung enthalten.
UIA _ IsControlElementPropertyId TRUE Das Statusleisten-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung 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 Statusleisten-Steuerelement derzeit nicht sichtbar ist, gibt es TRUE für diese Eigenschaft zurück.
UIA _ LabeledByPropertyId NULL Das Statusleisten-Steuerelement verfügt in der Regel nicht über eine Bezeichnung.
UIA _ LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem StatusBar-Steuerelementtyp entspricht. Der Standardwert ist "Statusleiste" 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. Unterscheiden Sie in diesem Fall jede Leiste 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, die für Statusleisten-Steuerelemente unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster Support Notizen
IGridProvider Optional Statusleisten-Steuerelemente sollten das Raster-Steuerelementmuster unterstützen, damit einzelne Teile überwacht und leicht auf Informationen verwiesen werden können.

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die Statusleistensteuerelemente 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 _ 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 _ StructureChangedEventId

Bemerkungen

Es wird empfohlen, Bearbeitungssteuerelemente als untergeordnete Rasterelemente in einer Statusleiste zu verwenden. Die Verwendung von Bearbeitungssteuerelementen erleichtert das Zuordnen des Zwecks des Statusfelds zu dessen Wert mithilfe des Elementnamens und der Werteigenschaft. Da Textsteuerelemente das Value-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