Freigeben über


Implementieren des RangeValue-Steuerelementmusters der Benutzeroberflächenautomatisierung

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.

In diesem Thema werden Richtlinien und Konventionen zum Implementieren von IRangeValueProvider vorgestellt sowie Ereignisse und Eigenschaften erläutert. Am Ende des Themas finden Sie Links zu zusätzlichen Verweisen.

Mit dem RangeValuePattern-Steuerelementmuster werden Steuerelemente unterstützt, für die ein Wert in einem Bereich festgelegt werden kann. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients.

Dieses Thema enthält folgende Abschnitte.

  • Implementierungsrichtlinien und Konventionen
  • Erforderliche Member für IRangeValueProvider
  • Ausnahmen
  • Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

Beachten Sie beim Implementieren des RangeValue-Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Steuerelemente lassen eine erneute Kalibrierung der unterstützten Eigenschaften auf Grundlage des Gebietsschemas oder einer Benutzereinstellung zu. Ein Beispiel hierfür ist ein Thermometersteuerelement, das so festgelegt werden kann, dass die Temperatur in Fahrenheit oder Celsius angezeigt wird.

  • Für Steuerelemente, die über mehrdeutige Bereichswerte verfügen, z. B. Statusanzeigen oder Schieberegler, sollten diese Werte normalisiert werden.

Beispiel für eine Statusanzeige, in der der Wert eine ganze Zahl ist und die minimalen und maximalen Eigenschaftswerte auf 0 (null) beziehungsweise 100 normalisiert werden

Statusanzeige.

Erforderliche Member für IRangeValueProvider

Erforderliche Member

Membertyp

Hinweise

IsReadOnlyProperty

Eigenschaft

Keine

ValueProperty

Eigenschaft

Keine

LargeChangeProperty

Eigenschaft

Keine

SmallChangeProperty

Eigenschaft

Keine

MaximumProperty

Eigenschaft

Keine

MinimumProperty

Eigenschaft

Keine

SetValue

Methoden

Keine

Dieses Steuerelementmuster verfügt über keine zugeordneten Ereignisse.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp

Bedingung

ArgumentOutOfRangeException

SetValue wird mit einem Wert aufgerufen, der entweder größer als MaximumProperty oder kleiner als MinimumProperty ist.

Siehe auch

Aufgaben

Unterstützung von Steuerelementmustern in einem Benutzeroberflächenautomatisierungs-Anbieter

Verwenden der Zwischenspeicherung in der Benutzeroberflächenautomatisierung

Konzepte

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Steuerelementmuster für Benutzeroberflächenautomatisierung für Clients

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur