Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu suwak
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 Suwak. 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 typów kontrolek.
Kontrolka Suwak to złożona kontrolka z przyciskami, które umożliwiają użytkownikowi ustawienie zakresu liczbowego lub wybranie z zestawu elementów przez użytkownika za pomocą myszy.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Suwak. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek suwaka, 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ące się do kontrolek suwaka i opisano, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacja interfejsu użytkownika, zobacz omówienie drzewa automatyzacja interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
| Suwak - Przycisk (2 lub 4) - Kciuk (tylko 1) - Element listy (co najmniej 0) |
Suwak - Element listy (co najmniej 0) |
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 typu kontrolki Suwak. 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 | Większość kontrolek suwaka musi podnieść NoClickablePointException wartość, ponieważ cały prostokąt ograniczenia kontrolki suwaka jest zajmowany przez kontrolki podrzędne. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Zobacz uwagi. | Nazwa kontrolki edycji jest zwykle generowana na podstawie statycznej etykiety tekstowej. Jeśli nie ma statycznej etykiety tekstowej, wartość Name właściwości musi zostać przypisana przez dewelopera aplikacji. Właściwość Name nigdy nie powinna zawierać zawartości tekstowej kontrolki edycji. |
| LabeledByProperty | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa skojarzona z kontrolką, ta właściwość musi uwidocznić odwołanie do tej kontrolki. Jeśli kontrolka tekstu jest podskładem innej kontrolki, nie będzie miała ustawionej LabeledBy właściwości. |
| ControlTypeProperty | Suwak | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "suwak" | Zlokalizowany ciąg odpowiadający typowi kontrolki Edycji. |
| IsContentElementProperty | Prawda | Kontrolka edycji jest zawsze uwzględniana w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka edycji jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki suwaka. 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 kontrolki | Pomoc techniczna | Uwagi |
|---|---|---|
| ISelectionProvider | Zależy | Suwak powinien obsługiwać wzorzec kontrolki Wybór, jeśli zawartość reprezentuje jedną wartość między dyskretnym zestawem opcji. Gdy wzorzec kontrolki Wybór jest obsługiwany, odpowiednie zaznaczenie musi być uwidocznione jako co najmniej jeden podrzędny element listy suwaka. |
| IRangeValueProvider | Zależy | Suwak powinien obsługiwać wzorzec kontrolki RangeValue, jeśli zawartość może być ustawiona na wartość w zakresie liczbowym. |
| IValueProvider | Zależy | Suwak powinien obsługiwać wzorzec kontrolki Wartość, jeśli zawartość reprezentuje jedną wartość między dyskretnym zestawem opcji. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki suwaka.
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 |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |