ProgressBar-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den ProgressBar-Steuerelementtyp.
Statusanzeige-Steuerelemente geben den Fortschritt eines längeren Vorgangs an. Das Steuerelement besteht aus einem Rechteck, das mit dem Fortschreiten eines Vorgangs allmählich mit der Hervorhebungsfarbe des Systems ausgefüllt wird.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ProgressBar-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Statusanzeigesteuerelemente, 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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Statusanzeige-Steuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung Struktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Die Statusleistensteuerelemente haben keine untergeordneten Elemente in der Steuerelement- oder Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für Statusleisten besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften 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 Benutzeroberflächenautomatisierung-Struktur eindeutig sein. |
| UIA _ BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| UIA _ ClickablePointPropertyId | Siehe Hinweise. | Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreibt und stellt einen klickbaren Punkt bereit. |
| UIA _ ControlTypePropertyId | ProgressBar | |
| UIA _ IsContentElementPropertyId | TRUE | Das Statusanzeige-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Statusanzeige-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-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 Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. |
| UIA _ LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem ProgressBar-Steuerelementtyp entspricht. Der Standardwert ist "Statusanzeige" für en-US oder Englisch (USA). |
| _UIA-NamePropertyId | Siehe Hinweise. | Das Statusanzeige-Steuerelement ruft seinen Namen in der Regel aus einer statischen Textbezeichnung ab. Wenn keine statische Textbezeichnung vorhanden ist, muss der Anwendungsentwickler einen Wert für die Eigenschaft „Name“ verfügbar machen. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von Statusanzeige-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Mustereigenschaft | Unterstützung/Wert | Notizen |
|---|---|---|
| IRangeValueProvider | Depends (Abhängig) | Statusanzeige-Steuerelemente, die einen numerischen Bereich annehmen, müssen das RangeValue-Steuerelementmuster implementieren. |
| Minimum | Depends (Abhängig) | Der Wert dieser Eigenschaft ist der Mindestwert, auf den das Steuerelement festgelegt werden kann. Dieser Wert sollte kleiner als Maximumsein. |
| Maximum | Depends (Abhängig) | Der Wert dieser Eigenschaft ist der maximale Wert, auf den das Steuerelement festgelegt werden kann. Dieser Wert sollte größer als Minimumsein. |
| Smallchange | NaN | Diese Eigenschaft ist nicht erforderlich, da Statusanzeige-Steuerelemente schreibgeschützt sind. |
| Largechange | NaN | Diese Eigenschaft ist nicht erforderlich, da Statusanzeige-Steuerelemente schreibgeschützt sind. |
| IValueProvider | Depends (Abhängig) | Statusanzeige-Steuerelemente, die eine Textanzeige des Fortschritts liefern, müssen das Wert-Steuerelementmuster implementieren. |
| IsReadOnly | TRUE | Der Wert für diese Eigenschaft ist immer TRUE. |
| Wert | Siehe Hinweise. | Durch diese Eigenschaft wird der Fortschritt eines Statusanzeige-Steuerelements als Text verfügbar. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die von Statusanzeigen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis. | |
| UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ Das NamePropertyId-Eigenschaftswechselereignis. | |
| UIA _ StructureChangedEventId | |
| UIA _ RangeValueValuePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das RangeValue-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ValueValuePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |