Freigeben über

CustomNavigation-Steuerelementmuster

  • Artikel

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

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

Dieses Thema enthält die folgenden Abschnitte.

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des CustomNavigation-Anbieters die folgenden Richtlinien und Konventionen:

  • Eigenschaftswerte für PositionInSet-, SizeOfSet-und Level sind 1-basierte ganzzahlige Werte.
  • ICustomNavigationProvider- bietet keine aktive Manipulation des Steuerelements, z. B. Verschieben von Positionen, Hinzufügen und Entfernen von Elementen oder Höherstufen und Herabstufen von Ebenen.
  • Steuerelemente, die ICustomNavigationProvider- implementieren, weisen in der Regel eine hierarchische Struktur auf, können aber Ebenen mithilfe der Navigate-Methode überspringen. Die Eigenschaften PositionInSet, SizeOfSet-und Level- sind für das Muster erforderlich.

Erforderliche Elemente für ICustomNavigationProvider-

Die folgenden Eigenschaften sind für die Implementierung der ICustomNavigationProvider Schnittstelle erforderlich.

Erforderliche Mitglieder Elementtyp Notizen
CachedLevel- Eigentum Befindet sich auf IUIAutomationElement4 Schnittstelle.
CachedPositionInSet- Eigentum Befindet sich auf IUIAutomationElement4 Schnittstelle.
CachedSizeOfSet- Eigentum Befindet sich auf IUIAutomationElement4 Schnittstelle.
CurrentLevel- Eigentum Befindet sich auf IUIAutomationElement4 Schnittstelle.
CurrentPositionInSet- Eigentum Befindet sich auf IUIAutomationElement4 Schnittstelle.
CurrentSizeOfSet- Eigentum Befindet sich auf IUIAutomationElement4 Schnittstelle.
Navigieren Methode Nichts

 

Dieses Steuerelementmuster weist keine zugeordneten Methoden oder Ereignisse auf.

Steuerelementtypen und deren unterstützte Steuerelementmuster

ListItem Control

HeaderItem-Steuerelement

DataItem Control

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung