Freigeben über


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

HinweisHinweis

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 Slider-Steuerelementtyp. In UI Automation besteht ein Steuerelementtyp aus einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementtypen ein.

Das Slider-Steuerelement ist ein zusammengesetztes Steuerelement mit Schaltflächen, über die ein Benutzer mit der Maus einen numerischen Bereich festlegen oder Elemente in einer Gruppe von Elementen auswählen kann.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Slider-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Slider-Steuerelemente, 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 Automation-Struktur für Slider-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

Schieberegler

  • Button (2 oder 4)

  • Ziehpunkt (nur 1)

  • Listenelement (0 oder mehr)

Schieberegler

  • Listenelement (0 oder mehr)

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für den Slider-Steuerelementtyp besonders relevant ist. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-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

Die meisten Slider-Steuerelemente müssen die NoClickablePointException auslösen, da das gesamte umschließende Rechteck des Slider-Steuerelements von untergeordneten Steuerelementen gefüllt wird.

IsKeyboardFocusableProperty

Siehe Hinweise.

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

NameProperty

Siehe Hinweise.

Der Name des Bearbeitungssteuerelements wird i. d. R. aus einer statischen Textbezeichnung generiert. Ist keine statische Textbezeichnung vorhanden, muss der Anwendungsentwickler Name einen Eigenschaftswert zuweisen. Die Name-Eigenschaft darf niemals den Textinhalt des Bearbeitungssteuerelements enthalten.

LabeledByProperty

Siehe Hinweise.

Wenn mit dem Steuerelement eine statische Textbezeichnung verknüpft ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. Wenn das Text-Steuerelement eine Unterkomponente eines anderen Steuerelements ist, wird für das Steuerelement keine LabeledBy-Eigenschaft festgelegt.

ControlTypeProperty

Schieberegler

Dieser Wert ist für alle UI-Frameworks identisch.

LocalizedControlTypeProperty

"Schieberegler"

Lokalisierte Zeichenfolge, die dem Bearbeitungssteuerelementtyp entspricht.

IsContentElementProperty

True

Das Bearbeitungssteuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten.

IsControlElementProperty

True

Das Bearbeitungssteuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von allen Slider-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster

Unterstützung

Hinweise

ISelectionProvider

Variabel

Ein Schieberegler muss das Selection-Steuerelementmuster unterstützen, wenn der Inhalt unter einem einzelnen Satz von Optionen einen Wert darstellt. Wenn das Selection-Steuerelementmuster unterstützt wird, muss die entsprechende Auswahl als ein oder mehrere untergeordnete Listenelemente des Schiebereglers verfügbar gemacht werden.

IRangeValueProvider

Variabel

Ein Schieberegler muss das RangeValue-Steuerelementmuster unterstützen, wenn der Inhalt auf einen Wert innerhalb eines numerischen Bereichs festgelegt werden kann.

IValueProvider

Variabel

Ein Schieberegler muss das Value-Steuerelementmuster unterstützen, wenn der Inhalt unter einem einzelnen Satz von Optionen einen Wert darstellt.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle werden die UI Automation-Ereignisse aufgelistet, die von allen Slider-Steuerelementen unterstützt werden müssen.

Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis

Unterstützung

Hinweise

InvalidatedEvent

Variabel

Keine

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 ValueProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Referenz

Slider

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung