StatusBar-Steuerelementtyp
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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Anmerkungen
- Zugehörige Themen
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 |
|---|---|
|
|
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.
Zugehörige Themen