ProgressBar-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den ProgressBar- Steuerelementtyp.
Statusleistensteuerelemente geben den Fortschritt eines langwierigen Vorgangs an. Das Steuerelement besteht aus einem Rechteck, das schrittweise mit der Systemmarkierungsfarbe gefüllt wird, während ein Vorgang fortschreitet.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ProgressBar- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Statusleistensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungs-Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Statusleistensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Die Statusleistensteuerelemente verfügen nicht über untergeordnete Elemente in der Steuerelement- oder Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Statusanzeigen relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| 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 | ProgressBar- | |
| UIA_IsContentElementPropertyId | TRUE- | Das Statusleisten-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsControlElementPropertyId | TRUE- | Das Statusleisten-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_LabeledByPropertyId | Siehe Hinweise. | Wenn eine statische Beschriftung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem steuerelementtyp ProgressBar entspricht. Der Standardwert ist "Statusanzeige" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Das Statusleisten-Steuerelement ruft in der Regel seinen Namen aus einer statischen Textbezeichnung ab. Wenn keine statische Textbeschriftung vorhanden ist, muss der Anwendungsentwickler einen Wert für die Name-Eigenschaft verfügbar machen. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von Statusleistensteuerelementen 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 |
|---|---|---|
| IRangeValueProvider- | Hängt | Statusleistensteuerelemente, die einen numerischen Bereich übernehmen, müssen das RangeValue- Steuerelementmuster implementieren. |
| Mindest- | Hängt | Der Wert dieser Eigenschaft ist der Mindestwert, auf den das Steuerelement festgelegt werden kann. Dieser Wert sollte kleiner als Maximumsein. |
| Maximale | Hängt | Der Wert dieser Eigenschaft ist der Maximalwert, auf den das Steuerelement festgelegt werden kann. Dieser Wert sollte größer als Minimumsein. |
| SmallChange- | NaN- | Diese Eigenschaft ist nicht erforderlich, da Statusleistensteuerelemente schreibgeschützt sind. |
| LargeChange- | NaN- | Diese Eigenschaft ist nicht erforderlich, da Statusleistensteuerelemente schreibgeschützt sind. |
| IValueProvider- | Hängt | Statusleistensteuerelemente, die einen textbezogenen Hinweis auf den Fortschritt geben, müssen das Wert- Steuerelementmuster implementieren. |
| IsReadOnly- | TRUE- | Der Wert für diese Eigenschaft ist immer TRUE. |
| Wert | Siehe Hinweise. | Diese Eigenschaft macht den Textfortschritt eines Statusleisten-Steuerelements verfügbar. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Statusanzeigen 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_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_RangeValueValuePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das RangeValue- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ValueValuePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Wert- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung