Partager via

Type de contrôle Slider

  • Article

Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle Slider.

Un contrôle de curseur est un contrôle composite avec des boutons qui permettent à un utilisateur de définir une plage numérique ou de sélectionner un ensemble d’éléments.

Les sections suivantes définissent la structure d’arborescence, les propriétés, les modèles de contrôle et les événements UI Automation requis pour le type de contrôle Slider. Les exigences UI Automation s’appliquent à tous les contrôles de curseur où l’infrastructure/la plateforme d’interface utilisateur intègre la prise en charge d’UI Automation pour les types de contrôle et les modèles de contrôle.

Cette rubrique contient les sections suivantes.

Structure d’arborescence classique

Le tableau suivant illustre un contrôle et une vue de contenu typiques de l’arborescence UI Automation qui se rapporte aux contrôles de curseur et décrit ce qui peut être contenu dans chaque vue. Pour plus d’informations sur l’arborescence UI Automation, consultez vue d’ensemble de l’arborescence UI Automation.

Vue contrôle Affichage de contenu
  • Glisseur
    • Bouton (2 ou 4)
    • Pouce (1)
    • Élément de liste (0 ou plus)
  • Glisseur
    • Élément de liste (0 ou plus)

 

Propriétés pertinentes

Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles de curseur. Pour plus d’informations sur les propriétés UI Automation, consultez Récupération des propriétés à partir d’UI Automation Elements.

UI Automation, propriété Valeur Notes
UIA_AutomationIdPropertyId Consultez les notes. La valeur de cette propriété doit être unique parmi tous les éléments homologues dans la vue brute de l’arborescence UI Automation.
UIA_BoundingRectanglePropertyId Consultez les notes. Rectangle le plus externe qui contient l’ensemble du contrôle.
UIA_ClickablePointPropertyId Consultez les notes. La majorité des contrôles de curseur doivent retourner l’erreur UIA_E_NOCLICKABLEPOINT, car le rectangle englobant entier du contrôle curseur est occupé par les contrôles enfants.
UIA_ControlTypePropertyId Curseur Cette valeur est la même pour toutes les infrastructures.
UIA_IsContentElementPropertyId VRAI Le contrôle de curseur est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId VRAI Le contrôle de curseur est toujours inclus dans la vue de contrôle de l’arborescence UI Automation.
UIA_IsKeyboardFocusablePropertyId Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. Les enfants (boutons et pouce) d’un contrôle curseur ne doivent jamais prendre le focus. Le focus doit toujours rester sur le contrôle de curseur lui-même.
UIA_LabeledByPropertyId Consultez les notes. S’il existe une étiquette de texte statique associée au contrôle, cette propriété doit exposer une référence à ce contrôle. Si le contrôle de texte est un sous-composant d’un autre contrôle, il n’aura pas de LabeledBy propriété définie.
UIA_LocalizedControlTypePropertyId Consultez les notes. Chaîne localisée correspondant au type de contrôle Slider. La valeur par défaut est « slider » pour en-US ou l’anglais (États-Unis).
UIA_NamePropertyId Consultez les notes. Le nom du contrôle de curseur est généralement généré à partir d’une étiquette de texte statique. S’il n’existe pas d’étiquette de texte statique, une valeur de propriété pour Nom doit être affectée par le développeur d’applications.

 

Modèles de contrôle requis

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par tous les contrôles de curseur. Pour plus d’informations sur les modèles de contrôle, consultez Vue d’ensemble des modèles de contrôle UI Automation.

Control Pattern/Pattern, propriété Prise en charge/valeur Notes
IRangeValueProvider Dépend Un curseur doit prendre en charge le modèle de contrôle RangeValue si le contenu peut être défini sur une valeur dans une plage numérique.
ISelectionProvider Dépend Un curseur doit prendre en charge le modèle de contrôle Sélection si le contenu représente une valeur parmi un ensemble discret d’options. Lorsque le modèle de contrôle Sélection est pris en charge, la sélection correspondante doit être exposée en tant qu’un ou plusieurs éléments de liste enfants du curseur.
IValueProvider Dépend Un curseur doit prendre en charge le modèle de contrôle valeur si le contenu représente une valeur parmi un ensemble discret d’options.

 

Événements obligatoires

Le tableau suivant répertorie les événements UI Automation requis pour prendre en charge les contrôles de curseur. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.

Événement UI Automation Notes
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId événement de modification de propriété.
UIA_IsEnabledPropertyId événement de modification de propriété. Si le contrôle prend en charge la propriété IsEnabled, il doit prendre en charge cet événement.
UIA_IsOffscreenPropertyId événement de modification de propriété. Si le contrôle prend en charge la propriété IsOffscreen, il doit prendre en charge cet événement.
UIA_RangeValueValuePropertyId événement de modification de propriété. Si le contrôle prend en charge le modèle de contrôle RangeValue, il doit prendre en charge cet événement.
UIA_Selection_InvalidatedEventId Si le contrôle prend en charge le modèle de contrôle Selection, il doit prendre en charge cet événement.
UIA_StructureChangedEventId
UIA_ValueValuePropertyId événement de modification de propriété. Si le contrôle prend en charge le modèle de contrôle valeur, il doit prendre en charge cet événement.

 

conceptuelle

Vue d’ensemble des types de contrôle UI Automation

Vue d’ensemble UI Automation