Udostępnij za pośrednictwem

Wzorzec kontrolki CustomNavigation

  • Artykuł

Opisuje wytyczne i konwencje implementowania interfejsu ICustomNavigationProvider, w tym informacje o właściwościach i metodach. Wzorzec sterowania CustomNavigation służy do włączania niestandardowej nawigacji między kontrolkami w strukturach przypominających hierarchię, takich jak elementy listy, listy punktowane, listy numerowane i nagłówki. Dzięki temu dostawcy mogą opisywać struktury lub definiować relacje nawigowalne przy użyciu samego elementu, a nie tylko kontrolki zawierającej.

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 dostawcy CustomNavigation należy pamiętać o następujących wytycznych i konwencjach:

  • Wartości właściwości PositionInSet, SizeOfSeti Level to jedno oparte wartości całkowite.
  • ICustomNavigationProvider nie zapewnia aktywnej manipulacji kontrolką, takiej jak przenoszenie pozycji, dodawanie i usuwanie elementów lub promowanie i obniżanie poziomu.
  • Kontrolki implementujące ICustomNavigationProvider zwykle mają strukturę hierarchiczną, ale mogą pomijać poziomy przy użyciu metody Navigate. Właściwości PositionInSet, SizeOfSeti Level są wymagane we wzorcu.

Wymagane elementy członkowskie ICustomNavigationProvider

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

Wymagane elementy członkowskie Typ elementu członkowskiego Notatki
CachedLevel Własność Znajduje się w interfejsie IUIAutomationElement4.
CachedPositionInSet Własność Znajduje się w interfejsie IUIAutomationElement4.
CachedSizeOfSet Własność Znajduje się w interfejsie IUIAutomationElement4.
CurrentLevel Własność Znajduje się w interfejsie IUIAutomationElement4.
CurrentPositionInSet Własność Znajduje się w interfejsie IUIAutomationElement4.
CurrentSizeOfSet Własność Znajduje się w interfejsie IUIAutomationElement4.
Navigate Metoda Żaden

 

Ten wzorzec kontrolki nie ma skojarzonych metod ani zdarzeń.

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

kontrolki ListItem

kontrolki HeaderItem

kontrolki DataItem

Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie