Partager via


Modèle de contrôle de défilement

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

Le contrôle n’est pas nécessaire pour utiliser des barres de défilement pour prendre en charge la fonctionnalité de défilement, bien qu’elle 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ôle 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.

Directives et conventions de mise en œuvre

Lors de l’implémentation du modèle de contrôle de défilement, 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 de défilement. Ils doivent prendre en charge le modèle de contrôle RangeValue à la place.
  • Lorsque le défilement est mesuré en pourcentages, toutes les valeurs ou quantités associées à la graduation de défilement doivent être normalisées à une plage de 0 à 100.
  • La propriété IScrollProvider ::HorizontallyScrollable et propriété VerticallyScrollable sont indépendantes de la propriété IsEnabled.
  • Si la propriété IScrollProvider ::HorizontallyScrollable est FALSE, la propriété HorizontalViewSize doit être définie sur 100 (100%) et propriété HorizontalScrollPercentPercent doit être définie sur UIA_ScrollPatternNoScroll (-1). De même, si la propriété VerticallyScrollable est FALSE, la propriété VerticalViewSizeSize doit être définie sur 100 (100%) et 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 un sens où le client n’est pas intéressé par le défilement devient activé.
  • La propriété IScrollProvider ::HorizontalScrollPercent est spécifique aux paramètres régionaux. La définition 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 lit de gauche à droite. Vous pouvez également définir HorizontalScrollPercent sur 100 pour définir l’emplacement de défilement à gauche.

Membres requis pour IScrollProvider

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

Membres obligatoires 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
défilement Méthode Aucun
SetScrollPercent Méthode Aucun

 

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

types de contrôle 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