Freigeben über


Implementieren des RangeValue-Steuerelementmusters der Benutzeroberflächenautomatisierung

Hinweis

Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.

In diesem Thema werden Richtlinien und Konventionen für die Implementierung IRangeValueProvidervorgestellt, einschließlich Informationen zu Ereignissen und Eigenschaften. Links zu zusätzlichen Referenzen sind am Ende dieses Themas aufgelistet.

Das RangeValuePattern Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die auf einen Wert innerhalb eines Bereichs festgelegt werden können. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementmusterzuordnung für Benutzeroberflächenautomatisierungs-Clients.

Implementierungsrichtlinien und -konventionen

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

  • Steuerelemente ermöglichen die Neukalibrierung ihrer unterstützten Eigenschaften basierend auf gebietsschema- oder Benutzereinstellungen. Ein Beispiel hierfür ist ein Thermometersteuerelement, das so eingestellt werden kann, dass die Temperatur in Fahrenheit oder Celsius angezeigt wird.

  • Steuerelemente mit mehrdeutigen Bereichswerten, z. B. Statusleisten oder Schiebereglern, sollten diese Werte normalisiert haben.

Fortschrittsbalken. Beispiel für einen Fortschrittsbalken, bei dem der Wert vom Typ "Ganzzahl" ist und die "Minimum"- und "Maximum"-Eigenschaftswerte jeweils auf "0" bzw. "100" normalisiert sind.

Erforderliche Mitglieder für IRangeValueProvider

Erforderlicher Member Memberart Hinweise
IsReadOnlyProperty Eigentum Nichts
ValueProperty Eigentum Nichts
LargeChangeProperty Eigentum Nichts
SmallChangeProperty Eigentum Nichts
MaximumProperty Eigentum Nichts
MinimumProperty Eigentum Nichts
SetValue Methodik Nichts

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

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

Siehe auch