Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu tabela
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 Tabela. 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 tabeli zawierają wiersze i kolumny tekstowe oraz opcjonalnie nagłówki wierszy i nagłówki kolumn.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Tabela. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek tabeli, 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 tabeli 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 |
|---|---|
| Table - Nagłówek (0 lub 1) - Tekst (0 lub 1) - Różne kontrolki (co najmniej 0) |
Table - Tekst (co najmniej 0) - Różne kontrolki (co najmniej 0) |
Jeśli kontrolka tabeli ma nagłówki wierszy lub kolumn, muszą być widoczne w widoku sterowania drzewa automatyzacja interfejsu użytkownika. Widok zawartości nie musi ujawniać tych informacji, ponieważ można uzyskać do niego dostęp za pomocą tabeli TablePattern.
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 Tabela. 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. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokątze ograniczenia jest klikalny, i wykonujesz wyspecjalizowane testowanie trafień, przesłoń i zapewnia punkt możliwy do kliknięcia. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Zobacz uwagi. | Kontrolka tabeli zwykle pobiera nazwę ze statycznej etykiety tekstowej. Jeśli nie ma statycznej etykiety tekstowej, musisz przypisać właściwość Name, która musi być zawsze dostępna, aby wyjaśnić przeznaczenie tabeli. |
| LabeledByProperty | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa, ta właściwość powinna uwidocznić odwołanie do elementu automatyzacji kontrolki. |
| ControlTypeProperty | Table | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "tabela" | Zlokalizowany ciąg odpowiadający typowi kontrolki Tabela. |
| HelpTextProperty | Zobacz uwagi. | Więcej szczegółów na temat przeznaczenia tabeli powinno być uwidocznione za pośrednictwem tej właściwości, jeśli nie jest wystarczająco wyjaśnione przez uzyskanie dostępu do właściwości NameProperty. |
| IsContentElementProperty | Prawda | Kontrolka tabeli musi zawsze być zawartością. |
| IsControlElementProperty | Prawda | Kontrolka tabeli musi zawsze być kontrolką. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki Tabeli. 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 |
|---|---|---|
| IGridProvider | Tak | Kontrolka tabeli zawsze obsługuje ten wzorzec kontrolki, ponieważ elementy, które zawiera, zawierają dane przedstawione w siatce. |
| IGridItemProvider | Tak (wymagane z obiektami podrzędnymi) | Obiekty wewnętrzne tabeli powinny obsługiwać wzorce kontrolek GridItem i TableItem. Sama tabela nie musi obsługiwać wzorców kontrolek GridItem lub TableItem, chyba że tabela jest częścią innej tabeli. |
| ITableProvider | Tak | Kontrolka tabeli zawsze ma możliwość posiadania nagłówków skojarzonych z zawartością. |
| ITableItemProvider | Tak (wymagane z obiektami podrzędnymi) | Obiekty wewnętrzne tabeli powinny obsługiwać wzorce kontrolek GridItem i TableItem. Sama tabela nie musi obsługiwać wzorców kontrolek GridItem lub TableItem, chyba że tabela jest częścią innej tabeli. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki tabeli. 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 |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |