Benutzeroberflächenautomatisierungs-Unterstützung für den ProgressBar-Steuerelementtyp
.gif "Hinweis") Hinweis |
|---|
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation. |
Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den ProgressBar-Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen enthalten bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte, Steuerelementmuster und UI Automation-Ereignisse.
Ein Beispiel für Steuerelemente, die den Statusanzeige-Steuerelementtyp implementieren, sind ProgressBar-Steuerelemente Mit Statusanzeige-Steuerelementen wird der Fortschritt längerer Vorgänge angezeigt. 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 UI Automation-Struktur, die -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den ProgessBar-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Listensteuerelemente, d. h. für Steuerelemente der Typen Windows Presentation Foundation (WPF), Win32 und Windows Forms.
Dieses Thema enthält folgende Abschnitte.
- Erforderliche Benutzeroberflächenautomatisierungs-Struktur
- Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
- Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften
- Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
- Verwandte Abschnitte
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die sich auf Statusanzeige-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
ProgressBar |
ProgressBar |
Die Statusanzeige-Steuerelemente haben keine untergeordneten Elemente in dem Steuerelement oder der Inhaltsansicht der UI Automation-Struktur.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition besonders für die Statusanzeige-Steuerelemente wichtig ist. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI Automation-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
|
Siehe Hinweise. |
Das äußere Rechteck, welches das gesamte Steuerelement umfasst. |
|
Siehe Hinweise. |
Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
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 Name-Eigenschaften verfügbar machen. |
|
Siehe Hinweise. |
Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen. |
|
ProgressBar |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
"Statusanzeige" |
Lokalisierte Zeichenfolge, die dem ProgressBar-Steuerelementtyp entspricht. |
|
True |
Das Statusanzeige-Steuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten. |
|
True |
Das Statusanzeige-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften
In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von Statusanzeige-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.
Steuerelementmuster/Mustereigenschaft |
Unterstützung/Wert |
Hinweise |
|---|---|---|
Variabel |
Statusanzeige-Steuerelemente, die den Fortschritt als Text anzeigen, müssen IValueProvider implementieren. |
|
True |
Der Wert für diese Eigenschaft ist immer True. |
|
Siehe Hinweise. |
Durch diese Eigenschaft wird der Textanzeige eines Statusanzeige-Steuerelements verfügbar. |
|
Variabel |
Statusanzeige-Steuerelemente, die einen numerischen Bereich erfordern, müssen IRangeValueProvider implementieren |
|
0.0 |
Der Wert dieser Eigenschaft wird auf den kleinsten Wert festgelegt, den das Steuerelement annehmen kann. |
|
100.0 |
Der Wert dieser Eigenschaft wird auf den größten Wert festgelegt, den das Steuerelement annehmen kann. |
|
NaN |
Diese Eigenschaft ist nicht erforderlich, da Statusanzeige-Steuerelemente schreibgeschützt sind. |
|
NaN |
Diese Eigenschaft ist nicht erforderlich, da Statusanzeige-Steuerelemente schreibgeschützt sind. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle werden die UI Automation-Ereignisse aufgelistet, die von allen Statusanzeige-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI Automation-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte NameProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis |
Variabel |
Keine |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Referenz
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung