Modèle de contrôle de défilement

  • Article

Décrit des instructions et des conventions pour l’implémentation d’IScrollProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle Scroll est utilisé pour prendre en charge un contrôle qui agit comme un conteneur avec défilement pour une collection d’objets enfants.

Le contrôle n’est pas obligé d’utiliser des barres de défilement pour prendre en charge la fonctionnalité de défilement, bien qu’il le fasse généralement. L’image suivante montre un contrôle de défilement qui n’utilise pas de barres de défilement. 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.

capture d’écran montrant un contrôle de défilement sans barres de défilement

Cette rubrique contient les sections suivantes.

Conventions et directives d'implémentation

Lors de l’implémentation du modèle de contrôle Scroll , notez les instructions et conventions suivantes :

  • Les enfants de ce contrôle doivent implémenter IScrollItemProvider.
  • Les barres de défilement d’un contrôle conteneur ne prennent pas en charge le modèle de contrôle Scroll . Ils doivent prendre en charge le modèle de contrôle RangeValue à la place.
  • Lorsque le défilement est mesuré sous forme de pourcentage, toutes les valeurs ou quantités liées à la graduation du défilement doivent être normalisées dans une plage de 0 à 100.
  • La propriété IScrollProvider::HorizontallyScrollable et la propriété VerticallyScrollable sont indépendantes de la propriété IsEnabled .
  • Si la propriété IScrollProvider::HorizontallyScrollable a la valeur FALSE, la propriété HorizontalViewSize doit être définie sur 100 (100 %) et la propriété HorizontalScrollPercent doit être définie sur UIA_ScrollPatternNoScroll (-1). De même, si la propriété VerticallyScrollable a la valeur FALSE, la propriété VerticalViewSize doit être définie sur 100 (100 %) et la propriété VerticalScrollPercent doit être définie sur UIA_ScrollPatternNoScroll (-1). Cela permet à un client Microsoft UI Automation d’utiliser ces valeurs de propriété dans la méthode SetScrollPercent tout en évitant une condition de concurrence si une direction que le client n’est pas intéressé par le défilement est activée.
  • La propriété IScrollProvider::HorizontalScrollPercent est spécifique aux paramètres régionaux. La définition de HorizontalScrollPercent sur 100 doit définir l’emplacement de défilement du contrôle sur l’équivalent de sa position la plus à droite pour les langues telles que l’anglais qui lisent de gauche à droite. Par ailleurs, pour les langues telles que l’arabe lus de droite à gauche, la définition de HorizontalScrollPercent sur 100 doit définir l’emplacement de défilement à la position la plus à gauche.

Membres requis pour IScrollProvider

Les propriétés et méthodes suivantes sont requises pour implémenter l’interface IScrollProvider .

Membres nécessaires Type de membre Notes
HorizontalScrollPercent Propriété Aucun
VerticalScrollPercent Propriété Aucun
HorizontalViewSize Propriété Aucun
VerticalViewSize Propriété Aucun
HorizontallyScrollable Propriété Aucun
VerticallyScrollable Propriété Aucun
Faire défiler Méthode Aucun
SetScrollPercent Méthode Aucun

 

Ce modèle de contrôle n’est associé aucun événement.

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

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

Vue d’ensemble de l’arborescence UI Automation