Implementacja wzorca formantu RangeValue dla automatyzacji interfejsu użytkownika

  • Artykuł

Uwaga

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacja interfejsu użytkownika zdefiniowanych w System.Windows.Automation przestrzeni nazw. Aby uzyskać najnowsze informacje na temat automatyzacja interfejsu użytkownika, zobacz Interfejs API usługi Windows Automation: automatyzacja interfejsu użytkownika.

W tym temacie przedstawiono wytyczne i konwencje implementacji IRangeValueProvider, w tym informacje o zdarzeniach i właściwościach. Linki do dodatkowych odwołań znajdują się na końcu tematu.

Wzorzec kontrolki RangeValuePattern służy do obsługi kontrolek, które można ustawić na wartość w zakresie. Przykłady kontrolek implementujących ten wzorzec kontrolki można znaleźć w temacie Control Pattern Mapping for automatyzacja interfejsu użytkownika Clients (Mapowanie wzorca kontrolek dla klientów automatyzacja interfejsu użytkownika).

Wytyczne i konwencje implementacji

Podczas implementowania wzorca kontrolki Wartość zakresu należy zwrócić uwagę na następujące wytyczne i konwencje:

  • Kontrolki umożliwiają ponownelibrację obsługiwanych właściwości na podstawie ustawień regionalnych lub preferencji użytkownika. Przykładem jest kontrolka termometru, którą można ustawić, aby wyświetlić temperaturę w stopniach Fahrenheita lub Celsjusza.

  • Kontrolki, które mają niejednoznaczne wartości zakresu, takie jak paski postępu lub suwaki, powinny mieć znormalizowane wartości.

Progress bar. Przykład paska postępu, gdzie wartość jest typu Liczba całkowita i Minimalna i Maksymalna wartość właściwości są znormalizowane odpowiednio do 0 i 100.

Wymagane elementy członkowskie dla elementu IRangeValueProvider

Wymagany element członkowski Typ elementu członkowskiego Uwagi
IsReadOnlyProperty Właściwości Brak
ValueProperty Właściwości Brak
LargeChangeProperty Właściwości Brak
SmallChangeProperty Właściwości Brak
MaximumProperty Właściwości Brak
MinimumProperty Właściwości Brak
SetValue Metody Brak

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

Dostawcy muszą zgłaszać następujące wyjątki.

Typ wyjątku Stan
ArgumentOutOfRangeException SetValue jest wywoływana z wartością większą lub mniejszą niż MaximumPropertyMinimumProperty.

Zobacz też