Udostępnij za pomocą


Implementacja wzorca kontrolki tabeli automatyzacji interfejsu użytkownika

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.

W tym temacie przedstawiono wytyczne i konwencje implementowania ITableProvider, w tym informacje o właściwościach, metodach i zdarzeniach. Linki do dodatkowych odwołań znajdują się na końcu przeglądu.

Wzorzec TablePattern kontrolki służy do obsługi kontrolek, które działają jako kontenery dla kolekcji elementów podrzędnych. Elementy podrzędne tego elementu muszą implementować ITableItemProvider i być zorganizowane w dwuwymiarowym układzie współrzędnych logicznych, który można przechodzić wierszami i kolumnami. Ten wzorzec kontrolki jest analogiczny do IGridProvider, z rozróżnieniem, że każda implementacja ITableProvider kontrolki musi również uwidocznić relację nagłówka kolumny i/lub wiersza dla każdego elementu podrzędnego. Przykłady kontrolek implementujących ten wzorzec kontrolki można znaleźć w temacie Control Pattern Mapping for UI Automation Clients.

Wytyczne i konwencje implementacji

Podczas implementowania wzorca kontrolki Tabela należy pamiętać o następujących wytycznych i konwencjach:

  • Dostęp do zawartości poszczególnych komórek odbywa się poprzez dwuwymiarowy układ współrzędnych logicznych lub tablicę, które są dostarczane przez wymaganą współbieżną implementację IGridProvider.

  • Nagłówek kolumny lub wiersza może być zawarty w obiekcie tabeli lub być oddzielnym obiektem nagłówka skojarzonym z obiektem tabeli.

  • Nagłówki kolumn i wierszy mogą zawierać zarówno nagłówek podstawowy, jak i nagłówki pomocnicze.

Uwaga / Notatka

Ta koncepcja staje się widoczna w arkuszu kalkulacyjnym programu Microsoft Excel, w którym użytkownik zdefiniował kolumnę "Imię". Ta kolumna ma teraz dwa nagłówki — nagłówek "Imię" zdefiniowany przez użytkownika i oznaczenie alfanumeryczne dla tej kolumny przypisanej przez aplikację.

Tabela z złożonymi elementami nagłówka. Przykład tabeli ze złożonymi nagłówkami kolumn

Tabela z niejednoznaczną właściwością RowOrColumnMajor. Przykład tabeli z niejednoznaczną właściwością RowOrColumnMajor

Wymagani członkowie dla ITableProvider

Następujące właściwości i metody są wymagane dla interfejsu ITableProvider.

Wymagani członkowie Typ członkostwa Notatki
RowOrColumnMajor Majątek Żaden
GetColumnHeaders Metoda Żaden
GetRowHeaders Metoda Żaden

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

Ten wzorzec kontrolki nie ma skojarzonych wyjątków.

Zobacz także