Obsługa automatyzacji interfejsu użytkownika dla formantów typu pokrętło
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.
Ten temat zawiera informacje o obsłudze automatyzacja interfejsu użytkownika dla typu kontrolki Spinner. W automatyzacja interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka ControlTypeProperty w celu użycia właściwości . Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacja interfejsu użytkownika, automatyzacja interfejsu użytkownika wartości właściwości i wzorce kontrolek.
Kontrolki pokrętła służą do wybierania z domeny elementów lub zakresu liczb.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Spinner. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek pokrętła, niezależnie od tego, czy Windows Presentation Foundation (WPF), Win32 lub Windows Forms.
Wymagana struktura drzewa automatyzacja interfejsu użytkownika
W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacja interfejsu użytkownika odnoszącego się do kontrolek pokrętła, gdy obsługują wzorce kontrolek Zakres wartości, Wartości i Wybór oraz opisano, co może być zawarte w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacja interfejsu użytkownika, zobacz omówienie drzewa automatyzacja interfejsu użytkownika.
Wzorzec kontrolki Wartość lub Wartość zakresu
| Widok kontrolki | Widok zawartości |
|---|---|
| Spinner - Edycja (0 lub 1) - Przycisk (2) |
Spinner |
Wzorzec kontrolki wyboru
| Widok kontrolki | Widok zawartości |
|---|---|
| Spinner - Edycja (0 lub 1) - Przycisk (2) - Element listy (co najmniej 0) |
Spinner - ListItem (co najmniej 0) |
Aby upewnić się, że dwa przyciski w widoku sterowania poddrzewo mogą być rozróżniane przez narzędzia do automatycznego testowania SmallIncrement , przypisz lub SmallDecrement AutomationId zgodnie z potrzebami. W przypadku niektórych implementacji skojarzona kontrolka Edytuj może być elementem równorzędnym kontrolki Spinner.
Wymagane właściwości automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono właściwości automatyzacja interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek pokrętła. Aby uzyskać więcej informacji na temat właściwości automatyzacja interfejsu użytkownika, zobacz automatyzacja interfejsu użytkownika Właściwości dla klientów.
| właściwość automatyzacja interfejsu użytkownika | Wartość | Uwagi |
|---|---|---|
| AutomationIdProperty | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa we wszystkich kontrolkach w aplikacji. |
| BoundingRectangleProperty | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| ClickablePointProperty | Zobacz uwagi. | Punkt klikalny kontrolki pokrętła koncentruje się na edytowanej części kontrolki. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Zobacz uwagi. | Kontrolka pokrętła zwykle pobiera nazwę ze statycznej etykiety tekstowej. |
| LabeledByProperty | Zobacz uwagi. | Kontrolki pokrętła mają statyczną etykietę tekstową. |
| ControlTypeProperty | Spinner | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "spinner" | Zlokalizowany ciąg odpowiadający typowi kontrolki Spinner. |
| IsContentElementProperty | Prawda | Kontrolka pokrętła musi zawsze być zawartością. |
| IsControlElementProperty | Prawda | Kontrolka pokrętła musi być zawsze kontrolką. |
Wymagane wzorce i właściwości kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki pokrętła. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz automatyzacja interfejsu użytkownika Control Patterns Overview (Omówienie wzorców kontrolek automatyzacja interfejsu użytkownika).
| Wzorzec/wzorzec kontrolki, właściwość | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| ISelectionProvider | Zależy | Kontrolki pokrętła, które mają wybrać listę elementów, muszą obsługiwać ten wzorzec. |
| CanSelectMultiple | Fałsz | Kontrolki pokrętła są zawsze pojedynczymi kontenerami wyboru. |
| IRangeValueProvider | Zależy | Kontrolki pokrętła obejmujące zakres liczbowy mogą obsługiwać ten wzorzec. |
| IValueProvider | Zależy | Kontrolki pokrętła obejmujące dyskretny zestaw opcji lub liczb mogą obsługiwać ten wzorzec. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki pokrętła. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| InvalidatedEvent | Zależy | Brak |
| BoundingRectangleProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsOffscreenProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsEnabledProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |