Wzorzec kontrolki tabeli

Opisuje wytyczne i konwencje implementowania ITableProvider, w tym informacje o właściwościach i metodach. Wzorzec kontrolki tabeli służy do obsługi kontrolek, które działają jako kontenery dla kolekcji elementów podrzędnych.

Elementy podrzędne elementu kontenera muszą implementować ITableItemProvider i być zorganizowane w dwuwymiarowym systemie 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 kontrolka implementujący ITableProvider musi również uwidocznić relację nagłówka kolumny i/lub wiersza dla każdego elementu podrzędnego. Aby zapoznać się z przykładami kontrolek implementujących ten wzorzec kontrolki, zobacz typy kontrolek i obsługiwane wzorce kontrolek.

Ten temat zawiera następujące sekcje.

• wytyczne i konwencje implementacji
• wymagane elementy członkowskie ITableProvider
• Tematy pokrewne

Wytyczne i konwencje implementacji

Podczas implementowania wzorca kontrolki tabeli 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 systemu 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.

  Nuta

  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, w tym nagłówek Imię zdefiniowany przez użytkownika, oraz oznaczenie alfanumeryczne dla tej kolumny przypisanej przez aplikację.

   

• Zobacz Wzorzec kontrolki siatki, aby zapoznać się z powiązanymi funkcjami siatki.

  Na poniższej ilustracji przedstawiono tabelę z złożonymi nagłówkami kolumn.

  

  Na poniższej ilustracji przedstawiono tabelę z niejednoznaczną właściwością ITableProvider::RowOrColumnMajor.

  

Wymagane elementy członkowskie ITableProvider

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

Wymagane elementy członkowskie	Typ elementu członkowskiego	Notatki
RowOrColumnMajor	Własność	Żaden
GetColumnHeaders	Metoda	Żaden
GetRowHeaders	Metoda	Żaden

 

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Tematy pokrewne

koncepcyjne

typów kontrolek i ich obsługiwanych wzorców kontrolek

wzorzec kontrolki TableItem

Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie

Omówienie drzewa automatyzacji interfejsu użytkownika