Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu ScrollBar
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 ScrollBar. 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 paska przewijania umożliwiają użytkownikowi przewijanie zawartości w kontenerze okna lub elementu. Kontrolka składa się z zestawu przycisków i kontrolki kciuka.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki ScrollBar. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek listy, 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 paska przewijania 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 |
|---|---|
| ScrollBar - Przycisk (2 lub 4) - Kciuk (0 lub1) |
Nie dotyczy. Kontrolka paska przewijania nie zawiera zawartości. |
Kontrolka paska przewijania zawsze ma od trzech do pięciu dzieci. Ponieważ poddrzewo ma więcej niż jedną kontrolkę przycisku, należy ustawić określoną AutomationIdProperty wartość dla każdego elementu, aby umożliwić ich odnajdywanie dla narzędzi automatyzacji testów.
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 paska przewijania. Należy pamiętać, że kontrolka paska przewijania nigdy nie ma zawartości; jego funkcjonalność jest widoczna za pośrednictwem wzorca kontrolki Przewijanie, który jest obsługiwany w przewijanym kontenerze.
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ę. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Null |
Kontrolka paska przewijania nie ma elementów zawartości i nie jest wymagana NameProperty do ustawienia. |
| ClickablePointProperty | Nie liczba. | Kontrolka paska przewijania nie ma punktów, które można klikać. |
| LabeledByProperty | Null |
Paski przewijania nie mają etykiet. |
| ControlTypeProperty | ScrollBar | Ta wartość jest taka sama dla wszystkich struktur. Paski przewijania, które działają jako suwaki, muszą używać typu kontrolki Suwak. |
| LocalizedControlTypeProperty | "Pasek przewijania" | Zlokalizowany ciąg odpowiadający typowi kontrolki Przycisk. |
| IsContentElementProperty | Fałsz | Kontrolka paska przewijania nigdy nie jest elementem zawartości. Jeśli pasek przewijania jest autonomiczną kontrolką, musi spełniać typ kontrolki Suwak i zwracać ControlType.Slider dla ControlType właściwości . |
| IsControlElementProperty | Prawda | Pasek przewijania musi zawsze być kontrolką. |
| OrientationProperty | Prawda | Kontrolka paska przewijania musi zawsze uwidaczniać orientację poziomą lub pionową. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki paska przewijania. 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). Należy pamiętać, że gdy pasek przewijania jest używany jako kontrolka tylko do manipulowania myszą, nie obsługuje wzorców sterowania. Jeśli jest używana jako kontrolka suwaka w aplikacji, musi mieć typ kontrolki Suwak.
| Wzorzec kontrolki | Pomoc techniczna | Uwagi |
|---|---|---|
| IScrollProvider | Nigdy | Wzorzec kontrolki Przewijanie nigdy nie jest bezpośrednio obsługiwany na pasku przewijania. |
| IRangeValueProvider | Zależy | Ta funkcja jest wymagana do obsługi tylko wtedy, gdy wzorzec kontrolki Przewijanie nie jest obsługiwany w kontenerze, który ma pasek przewijania. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki paska przewijania. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| 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 |
| HorizontallyScrollableProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| HorizontalScrollPercentProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| HorizontalViewSizeProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| VerticalScrollPercentProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| VerticallyScrollableProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| VerticalViewSizeProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |