Benutzeroberflächenautomatisierungs-Unterstützung für den ProgressBar-Steuerelementtyp

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den ProgressBar-Steuerelementtyp. In UI-Automatisierung 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-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte, Steuerelementmuster und UI-Automatisierung-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-Automatisierung-Struktur, die -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den ProgessBar-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-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 Steuerelementmuster der Benutzeroberflächenautomatisierung
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur, die sich auf Statusanzeige-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-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-Automatisierung-Struktur.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die UI-Automatisierung-Eigenschaften aufgelistet, deren Wert oder Definition besonders für die Statusanzeige-Steuerelemente wichtig ist. Weitere Informationen über UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI-Automatisierung-Eigenschaft

Wert

Hinweise

AutomationIdProperty()

Siehe Hinweise.

Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere, das gesamte Steuerelement umfassende Rechteck.

ClickablePointProperty

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.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

NameProperty

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.

LabeledByProperty

Siehe Hinweise.

Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen.

ControlTypeProperty

ProgressBar

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

LocalizedControlTypeProperty

"Statusanzeige"

Lokalisierte Zeichenfolge, die dem ProgressBar-Steuerelementtyp entspricht.

IsContentElementProperty

True

Das Statusanzeige-Steuerelement ist stets in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten.

IsControlElementProperty

True

Das Statusanzeige-Steuerelement ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI-Automatisierung-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

IValueProvider

Variabel

Statusanzeige-Steuerelemente, die den Fortschritt als Text anzeigen, müssen IValueProvider implementieren.

IsReadOnly

True

Der Wert für diese Eigenschaft ist immer True.

Value

Siehe Hinweise.

Durch diese Eigenschaft wird der Textanzeige eines Statusanzeige-Steuerelements verfügbar.

IRangeValueProvider

Variabel

Statusanzeige-Steuerelemente, die einen numerischen Bereich erfordern, müssen IRangeValueProvider implementieren

Minimum

0.0

Der Wert dieser Eigenschaft muss auf den kleinsten Wert festgelegt werden, den das Steuerelement annehmen kann.

Maximum

100.0

Der Wert dieser Eigenschaft muss auf den größten Wert festgelegt werden, den das Steuerelement annehmen kann.

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.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle werden die UI-Automatisierung-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-Automatisierung-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

Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

ProgressBar