Partager via


Modèle de contrôle CustomNavigation

Décrit les instructions et conventions relatives à l’implémentation de l’interface ICustomNavigationProvider , y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle CustomNavigation est utilisé pour activer la navigation personnalisée entre les contrôles dans des structures de type hiérarchie telles que les éléments de liste, les listes à puces, les listes numérotées et les en-têtes. Cela permet aux fournisseurs de décrire des structures ou de définir les relations navigables à l’aide de l’élément seul et pas seulement du contrôle contenant.

Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Types de contrôles et leurs modèles de contrôle pris en charge.

Cette rubrique contient les sections suivantes.

Conventions et directives d'implémentation

Lors de l’implémentation du fournisseur CustomNavigation , notez les directives et conventions suivantes :

  • Les valeurs de propriété pour PositionInSet, SizeOfSet et Level sont des valeurs entières de base unique.
  • ICustomNavigationProvider ne fournit pas de manipulation active du contrôle, comme le déplacement de positions, l’ajout et la suppression d’éléments, ou la promotion et la rétrogradation de niveaux.
  • Les contrôles qui implémentent ICustomNavigationProvider ont généralement une structure hiérarchique, mais peuvent ignorer des niveaux à l’aide de la méthode Navigate . Les propriétés PositionInSet, SizeOfSet et Level sont requises sur le modèle.

Membres obligatoires pour ICustomNavigationProvider

Les propriétés suivantes sont requises pour implémenter l’interface ICustomNavigationProvider .

Membres nécessaires Type de membre Notes
CachedLevel Propriété Situé sur l’interface IUIAutomationElement4 .
CachedPositionInSet Propriété Situé sur l’interface IUIAutomationElement4 .
CachedSizeOfSet Propriété Situé sur l’interface IUIAutomationElement4 .
CurrentLevel Propriété Situé sur l’interface IUIAutomationElement4 .
CurrentPositionInSet Propriété Situé sur l’interface IUIAutomationElement4 .
CurrentSizeOfSet Propriété Situé sur l’interface IUIAutomationElement4 .
Naviguer Méthode Aucun

 

Ce modèle de contrôle n’est associé à aucune méthode ou aucun événement.

Types de contrôles et leurs modèles de contrôle pris en charge

Contrôle ListItem

Contrôle HeaderItem

Contrôle DataItem

Vue d'ensemble des modèles de contrôle UI Automation