Udostępnij za pomocą

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

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 Tabela. 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 tabeli zawierają wiersze i kolumny tekstowe oraz opcjonalnie nagłówki wierszy i nagłówki kolumn.

W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Tabela. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.

Widok sterowania Widok zawartości
Tabela

- Nagłówek (0 lub 1)
- Tekst (0 lub 1)
- Różne kontrolki (0 lub więcej)		 Tabela

- Tekst (0 lub więcej)
- Różne kontrolki (0 lub więcej)

Jeśli kontrolka tabeli zawiera nagłówki wierszy lub kolumn, muszą być uwidocznione w widoku sterowania drzewa automatyzacji 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 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 kontrolek Tabela. 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ę.
ClickablePointProperty Zobacz uwagi. Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokącie ograniczającym jest klikalny i wykonujesz wyspecjalizowane testowanie trafień, zapewnij punkt, który jest 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 Tabela Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
LocalizedControlTypeProperty "tabela" Zlokalizowany ciąg odpowiadający typowi kontrolki tabeli.
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 zawierać treść.
IsControlElementProperty Prawda Kontrolka tabeli musi być zawsze kontrolką.

Wymagane wzorce kontrolek automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika, które muszą być obsługiwane przez kontrolki tabeli. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.

Wzorzec kontrolki Wsparcie Notatki
IGridProvider Tak Kontrolka tabeli zawsze obsługuje ten wzorzec kontroli, ponieważ elementy w niej zawarte są przedstawiane jako dane w formie siatki.
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 automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek tabeli. 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
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także

  • Last updated on