Obsługa automatyzacji interfejsu użytkownika dla formantów typu karta
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 Tab. 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, wartości właściwości automatyzacja interfejsu użytkownika i automatyzacja 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 automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Tab. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek kart, 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 tabulacji 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 |
|---|---|
Tab
|
Tab - TabItem (co najmniej 1) |
Kontrolki tabulacji mają elementy podrzędne automatyzacja interfejsu użytkownika oparte na typie kontrolki Element tabulacji. 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 kontrolki | Widok zawartości |
|---|---|
Tab
|
Tab
|
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 Tab. 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 | Zobacz uwagi. | Kontrolka karty rzadko wymaga właściwości Name. |
| 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 | Tab | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "tab" | Zlokalizowany ciąg odpowiadający typowi kontrolki Tab. |
| IsKeyboardFocusableProperty | Prawda | Typ kontrolki Tab musi mieć możliwość odbierania fokusu klawiatury. Zazwyczaj klient automatyzacja interfejsu użytkownika wywołuje kontrolkę SetFocus na kontrolce tabulacji, a jeden z jego elementów przekazuje fokus klawiatury do kontrolki tabulacji. 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 automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka karty jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja 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 kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki kart. 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 | Tak | Wszystkie kontrolki kart muszą obsługiwać wzorzec zaznaczenia. |
| IsSelectionRequired | Prawda | Kontrolki tabulacji zawsze wymagają wyboru. |
| CanSelectMultiple | Fałsz | Kontrolki tabulacji są zawsze kontenerami z jednym wyborem. |
| IScrollProvider | Zależy | Wzorzec przewijania musi być obsługiwany w kontrolce karty zawiera widżety, które umożliwiają przewijanie zestawu elementów tabulacji. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki kart. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | 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. | Zależy | Brak |
| HorizontalScrollPercentProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| HorizontallyScrollableProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| HorizontalViewSizeProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| VerticalScrollPercentProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| VerticalViewSizeProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |