Udostępnij za pomocą

Obsługa automatyzacji interfejsu użytkownika dla typu kontrolki ScrollBar

Uwaga / Notatka

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

Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika dla typu kontrolki ScrollBar. W Automatyzacji interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka, aby korzystać z właściwości ControlTypeProperty. Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców 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 automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki ScrollBar. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji interfejsu użytkownika odnoszący się do kontrolek paska przewijania i opisano, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.

Widok sterowania Widok zawartości
Pasek przewijania

- 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 przypisać każdemu elementowi określoną wartość AutomationIdProperty, aby były one łatwe do wykrycia przez narzędzia automatyzacji testów.

Wymagane właściwości automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotne dla kontrolek paska przewijania. Należy pamiętać, że kontrolka paska przewijania nigdy nie zawiera treści; jej funkcjonalność jest widoczna za pośrednictwem wzorca kontrolki przewijania, który jest obsługiwany w przewijanym kontenerze.

Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Właściwości automatyzacji interfejsu użytkownika dla klientów.

Właściwość automatyzacji interfejsu użytkownika Wartość Notatki
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 wymagane ustawienie NameProperty.
ClickablePointProperty Nie liczba. Kontrolka paska przewijania nie ma punktów, które można klikać.
LabeledByProperty Null Paski przewijania nie mają etykiet.
ControlTypeProperty Pasek przewijania Ta wartość jest taka sama dla wszystkich struktur. Paski przewijania działające jako suwaki muszą używać kontrolki typu Suwak.
LocalizedControlTypeProperty Pasek przewijania Zlokalizowany ciąg odpowiadający typowi kontrolki Przycisk.
IsContentElementProperty Nieprawda 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 właściwości ControlType.
IsControlElementProperty Prawda Pasek przewijania musi zawsze być kontrolką.
OrientationProperty Prawda Kontrolka paska przewijania musi zawsze uwidaczniać orientację poziomą lub pionową.

Wymagane wzorce kontrolek automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki paska przewijania. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie. 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 Wsparcie Notatki
IScrollProvider Nigdy Wzorzec przewijania kontrolki nigdy nie jest bezpośrednio obsługiwany na pasku przewijania.
IRangeValueProvider Zależy Obsługa tej funkcji jest wymagana tylko wtedy, gdy wzorzec sterowania przewijaniem nie jest obsługiwany w kontenerze, który ma pasek przewijania.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki paska przewijania. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.

Zdarzenie automatyzacji interfejsu użytkownika Pomoc techniczna/wartość Notatki
BoundingRectangleProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsOffscreenProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsEnabledProperty zdarzenie zmiany właściwości. Wymagane Żaden
HorizontallyScrollableProperty zdarzenie zmiany właściwości. Nigdy Żaden
HorizontalScrollPercentProperty zdarzenie zmiany właściwości. Nigdy Żaden
HorizontalViewSizeProperty zdarzenie zmiany właściwości. Nigdy Żaden
VerticalScrollPercentProperty zdarzenie zmiany właściwości. Nigdy Żaden
VerticallyScrollableProperty zdarzenie zmiany właściwości. Nigdy Żaden
VerticalViewSizeProperty zdarzenie zmiany właściwości. Nigdy Żaden
ValueProperty zdarzenie zmiany właściwości. Zależy Żaden
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także

  • Last updated on