Implementacja wzorca formantu tabeli automatyzacji interfejsu użytkownika

  • Artykuł

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.

W tym temacie przedstawiono wytyczne i konwencje implementacji 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ć przez wiersz i kolumnę. 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 automatyzacja interfejsu użytkownika Clients (Mapowanie wzorca kontrolek dla klientów automatyzacja interfejsu użytkownika).

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ę za pośrednictwem dwuwymiarowego układu współrzędnych logicznych lub tablicy dostarczonej 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

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ę.

  • Zobacz Implementowanie wzorca kontrolki siatki automatyzacja interfejsu użytkownika, aby zapoznać się z powiązanymi funkcjami siatki.

Table with complex header items. Przykład tabeli ze złożonymi nagłówkami kolumn

Table with ambiguous RowOrColumnMajor property. Przykład tabeli z niejednoznaczną właściwością RowOrColumnMajor

Wymagane elementy członkowskie dla dostawcy ITableProvider

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

Wymagane elementy członkowskie Typ elementu członkowskiego Uwagi
RowOrColumnMajor Właściwości Brak
GetColumnHeaders Method Brak
GetRowHeaders Method Brak

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

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

Zobacz też