Freigeben über


CustomNavigation-Steuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung der ICustomNavigationProvider-Schnittstelle , einschließlich Informationen zu Eigenschaften und Methoden. Das CustomNavigation-Steuerelementmuster wird verwendet, um die benutzerdefinierte Navigation zwischen Steuerelementen in hierarchieähnlichen Strukturen wie Listenelementen, Aufzählungen, nummerierten Listen und Überschriften zu ermöglichen. Dadurch können Anbieter Strukturen beschreiben oder die navigierbaren Beziehungen nur mithilfe des Elements und nicht nur des enthaltenden Steuerelements definieren.

Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und ihre unterstützten Steuerelementmuster.

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren des CustomNavigation-Anbieters die folgenden Richtlinien und Konventionen:

  • Eigenschaftswerte für PositionInSet, SizeOfSet und Level sind einbasierte ganzzahlige Werte.
  • ICustomNavigationProvider bietet keine aktive Bearbeitung des Steuerelements, z. B. Verschieben von Positionen, Hinzufügen und Entfernen von Elementen oder Herstufen und Herabstufen von Ebenen.
  • Steuerelemente, die ICustomNavigationProvider implementieren, verfügen in der Regel über eine hierarchische Struktur, können jedoch Ebenen mithilfe der Navigate-Methode überspringen. Die Eigenschaften PositionInSet, SizeOfSet und Level sind für das Muster erforderlich.

Erforderliche Member für ICustomNavigationProvider

Die folgenden Eigenschaften sind erforderlich, um die ICustomNavigationProvider-Schnittstelle zu implementieren.

Erforderliche Member Memberart Hinweise
CachedLevel Eigenschaft Befindet sich auf der IUIAutomationElement4-Schnittstelle .
CachedPositionInSet Eigenschaft Befindet sich auf der IUIAutomationElement4-Schnittstelle .
CachedSizeOfSet Eigenschaft Befindet sich auf der IUIAutomationElement4-Schnittstelle .
CurrentLevel Eigenschaft Befindet sich auf der IUIAutomationElement4-Schnittstelle .
CurrentPositionInSet Eigenschaft Befindet sich auf der IUIAutomationElement4-Schnittstelle .
CurrentSizeOfSet Eigenschaft Befindet sich auf der IUIAutomationElement4-Schnittstelle .
Navigieren Methode Keine

 

Diesem Steuerelementmuster sind keine Methoden oder Ereignisse zugeordnet.

Steuerelementtypen und ihre unterstützten Steuerelementmuster

ListItem-Steuerelement

HeaderItem-Steuerelement

DataItem-Steuerelement

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung