Wzorzec kontrolki siatki
Opisuje wytyczne i konwencje implementowania IGridProvider, w tym informacje o właściwościach i metodach. Wzorzec kontrolki Grid 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ć IGridItemProvider i być zorganizowane w dwuwymiarowym układzie współrzędnych logicznych, który można przechodzić przez wiersz i kolumnę. 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
Podczas implementowania wzorca kontrolki Grid należy pamiętać o następujących wytycznych i konwencjach:
Współrzędne siatki są oparte na zerach z lewym górnym (lub prawą górną komórką w zależności od ustawień regionalnych) o współrzędnych (0,0).
Jeśli komórka jest pusta, element automatyzacji interfejsu użytkownika firmy Microsoft musi być nadal zwracany, aby obsługiwać właściwość IGridItemProvider::ContainingGrid dla tej komórki. Jest to możliwe, gdy układ elementów podrzędnych w siatce jest podobny do poszarpanej tablicy (zobacz przykład poniżej).
Siatka z pojedynczym elementem jest nadal wymagana do zaimplementowania IGridProvider, jeśli jest logicznie uważana za siatkę. Liczba elementów podrzędnych w siatce jest niematerialna.
Ukryte wiersze i kolumny, w zależności od implementacji dostawcy, mogą zostać załadowane w drzewie automatyzacji interfejsu użytkownika i dlatego zostaną odzwierciedlone we właściwościach IGridProvider::RowCount i ColumnCount. Jeśli ukryte wiersze i kolumny nie zostały jeszcze załadowane, nie powinny być zliczane.
IGridProvider nie umożliwia aktywnego manipulowania siatką; ITransformProvider należy zaimplementować w celu włączenia tej funkcji.
Użyj IUIAutomationStructureChangedEventHandler, aby nasłuchiwać zmian strukturalnych lub układu siatki, takich jak komórki, które zostały dodane, usunięte lub scalone.
Użyj IUIAutomationFocusChangedEventHandler do śledzenia przechodzenia przez elementy lub komórki siatki.
Wymagane elementy członkowskie IGridProvider
Następujące właściwości i metody są wymagane do zaimplementowania interfejsu IGridProvider.
| Wymagane elementy członkowskie | Typ elementu członkowskiego | Notatki |
|---|---|---|
| RowCount | Własność | Żaden |
| ColumnCount | Własność | Żaden |
| GetItem | Metoda | Żaden |
Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.
Tematy pokrewne
-
wzorzec kontrolki GridItem
-
Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie