Partager via

Prise en charge d'UI Automation pour le type de contrôle SplitButton

Remarque

Cette documentation est destinée aux développeurs .NET Framework qui souhaitent utiliser les classes UI Automation managées définies dans l’espace de noms System.Windows.Automation. Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation.

Cette rubrique fournit des informations sur le support d'UI Automation pour le type de contrôle SplitButton. Dans UI Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour utiliser la ControlTypeProperty propriété. Les conditions incluent des instructions spécifiques pour la structure d’arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle.

Le contrôle bouton fractionné permet d’effectuer une action sur un contrôle et de développer le contrôle pour afficher la liste d’autres actions possibles qui peuvent être effectuées.

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 SplitButton. Les exigences d'UI Automation s'appliquent à tous les contrôles de bouton fractionné, que ce soit dans Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre l’affichage de contrôle et l’affichage de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de bouton fractionné 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
SplitButton

  • Image (0 ou 1)
  • Texte (0 ou 1)
  • Bouton (1 ou 2)

    • Menu (0 ou 1 ; apparaît en tant qu’enfant du bouton qui prend en charge le modèle ExpandCollapse)
    • Élément de menu (1 à plusieurs)
 SplitButton

- Élément de menu (un à plusieurs)

Propriétés UI Automation obligatoires

Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour fractionner les contrôles de bouton. Pour plus d’informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.

Propriété UI Automation Valeur Remarques
AutomationIdProperty Consultez les notes. La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty Consultez les notes. Rectangle le plus externe qui contient l’ensemble du contrôle.
ClickablePointProperty Consultez les notes. Prise en charge s’il existe un rectangle englobant. Si les points du rectangle englobant ne sont pas tous interactifs et que vous effectuez un test de positionnement spécialisé, vous devez remplacer et fournir un point interactif.
IsKeyboardFocusableProperty Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty « Retour » Le nom du contrôle du bouton fractionné est affiché sur le bouton.
LabeledByProperty Zéro Les contrôles de bouton fractionné n’ont pas d’étiquette de texte statique.
ControlTypeProperty SplitButton Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty "bouton partagé" Chaîne localisée correspondant au type de contrôle SplitButton.
HelpTextProperty Consultez les notes. Le texte d’aide peut indiquer le résultat de l’activation du bouton partagé, qui contient généralement le même type d’informations que celles présentées via une info-bulle.
IsContentElementProperty Vrai Le contrôle bouton fractionné contient des informations pour l’utilisateur final.
IsControlElementProperty Vrai Le contrôle bouton fractionné est visible pour l’utilisateur final.

Modèles de contrôle UI Automation obligatoires

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

Modèle de contrôle Soutien Remarques
IInvokeProvider Obligatoire Les boutons fractionnés ont toujours une action par défaut associée à Invoke.
IExpandCollapseProvider Obligatoire Les boutons fractionnés ont toujours la possibilité de développer une liste d’options.

Événements UI Automation obligatoires

Le tableau suivant répertorie les événements UI Automation requis pour être pris en charge par tous les contrôles de bouton fractionné. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.

Événement UI Automation Soutien Remarques
InvokedEvent Obligatoire Aucun
Événement de modification de la propriété BoundingRectangleProperty. Obligatoire Aucun
Événement de modification de la propriété IsOffscreenProperty. Obligatoire Aucun
Événement de modification de la propriété IsEnabledProperty. Obligatoire Aucun
Événement de modification de la propriété ExpandCollapseStateProperty. Obligatoire Aucun
AutomationFocusChangedEvent Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun

Exemple de contrôle SplitButton

L’image suivante illustre un contrôle de type SplitButton dans un contrôle de grille de données.

Bouton Fractionner

L’affichage de contrôle et l’affichage du contenu de l’arborescence UI Automation relative au contrôle de grille de données et au contrôle bouton partagé sont indiqués ci-dessous. Les modèles de contrôle pour chaque élément Automation sont affichés entre parenthèses.

Arborescence UI Automation - Vue contrôle Arborescence UI Automation - Affichage contenu
  • SplitButton "Nom" (Invoke, ExpandCollapse)
  • Bouton « Autres options » (Invoquer)

    • Menu
    • Élément de menu
    • …
  • SplitButton "Nom" (Invoke, ExpandCollapse)
  • Bouton « Autres options » (Invoquer)

    • Menu
    • Élément de menu
    • …

Voir aussi