Udostępnij za pomocą


Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu tabulacji

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 Tab. 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 automatyzacji interfejsu użytkownika. wzorce kontrolek.

Kontrolka tabulatora jest analogiczna do rozdzielaczy w notesie lub etykietach w szafce plików. Za pomocą kontrolki tabulatora aplikacja może definiować wiele stron dla tego samego obszaru okna lub okna dialogowego.

W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Tab. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek kart, niezależnie od tego, czy to Windows Presentation Foundation (WPF), Win32, czy 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 tabulacji 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
Zakładka

  • TabItem (co najmniej 1)
  • Pasek przewijania (0 lub 1)

    • Przycisk (0 lub 2)
Zakładka

- TabItem (1 lub więcej)

Kontrolki zakładek zawierają podrzędne elementy automatyzacji interfejsu użytkownika oparte na typie kontrolki zakładki. Gdy elementy karty są grupowane (na przykład w aplikacjach pakietu Microsoft Office 2007), typ kontrolki Tab może również hostować typy kontrolek Grupy dla elementów kart pogrupowanych, jak pokazuje poniższa struktura drzewa.

Widok sterowania Widok zawartości
Zakładka

  • TabItem (co najmniej 1)
  • Grupa (co najmniej 0)

    • TabItem (co najmniej 0)
  • Pasek przewijania (co najmniej 0)

    • Przycisk (0 lub 2)
Zakładka

  • TabItem (co najmniej 1)
  • Grupa (co najmniej 0)

    • TabItem (co najmniej 0)

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 istotna dla typu kontrolki Tab. 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 Zobacz uwagi. Kontrolka zakładki rzadko wymaga nazwy.
ClickablePointProperty Nie. Kontrolka karty nie ma punktu umożliwiającego klikanie.
LabeledByProperty Zobacz uwagi. Kontrolki tabulacji zwykle mają statyczną etykietę tekstową uwidacznianą za pośrednictwem tej właściwości.
ControlTypeProperty Zakładka Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
LocalizedControlTypeProperty zakładka Zlokalizowany ciąg odpowiadający typowi kontrolki Tab.
IsKeyboardFocusableProperty Prawda Typ kontrolki Tab musi mieć możliwość odbierania fokusu klawiatury. Zazwyczaj klient automatyzacji UI wywołuje metodę SetFocus na kontrolce zakładek, a jeden z jej elementów przekazuje fokus klawiatury do kontrolki zakładek. W przypadku niektórych kontenerów kart można skupić się bez ustawiania fokusu na jednym z jego elementów.
IsContentElementProperty Prawda Kontrolka karty jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika.
IsControlElementProperty Prawda Kontrolka karty jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika.
OrientationProperty Zobacz uwagi. Kontrolka tabulacji musi zawsze wskazywać, czy jest umieszczona w poziomie, czy w pionie.

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

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek kart. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.

Wzorzec/wzorzec kontrolki, właściwość Pomoc techniczna/wartość Notatki
ISelectionProvider Tak Wszystkie kontrolki kart muszą obsługiwać wzorzec wyboru.
IsSelectionRequired Prawda Kontrolki tabulacji zawsze wymagają wyboru.
CanSelectMultiple Nieprawda Kontrolki tabulacji są zawsze kontenerami z jednym wyborem.
IScrollProvider Zależy Wzorzec przewijania musi być obsługiwany w kontrolce kart, która zawiera widżety umożliwiające przewijanie zestawu elementów tabulacji.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

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

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie 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. Zależy Żaden
HorizontalScrollPercentProperty zdarzenie zmiany właściwości. Zależy Żaden
HorizontallyScrollableProperty zdarzenie zmiany właściwości. Zależy Żaden
HorizontalViewSizeProperty zdarzenie zmiany właściwości. Zależy Żaden
VerticalScrollPercentProperty zdarzenie zmiany właściwości. Zależy Żaden
VerticalViewSizeProperty zdarzenie zmiany właściwości. Zależy Żaden
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także