Partager via


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

RemarqueRemarque

Cette documentation s'adresse aux développeurs .NET Framework qui veulent 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 (page éventuellement en anglais).

Cette rubrique fournit des informations sur la prise en charge 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 afin d'utiliser la propriété ControlTypeProperty. Les conditions incluent des indications spécifiques pour l'arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle.

Le contrôle bouton partagé offre la possibilité d'exécuter une action sur un contrôle et de développer le contrôle pour consulter une liste d'autres actions possibles pouvant être exécutées.

Les sections suivantes définissent l'arborescence UI Automation, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle SplitButton. Les spécifications UI Automation s'appliquent à tous les contrôles bouton partagé, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Cette rubrique comprend les sections suivantes.

  • Arborescence d'UI Automation requise
  • Propriétés UI Automation requises
  • Modèles de contrôle d'UI Automation requis
  • Événements d'UI Automation requis
  • Exemple de contrôle SplitButton
  • Rubriques connexes

Arborescence d'UI Automation requise

Le tableau suivant représente l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles bouton partagé et décrit ce qui peut être inclus dans chaque affichage. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.

Affichage de contrôle

Affichage du contenu

SplitButton

  • Image (0 ou 1)

  • Texte (0 ou 1)

  • Button (1 ou 2)

    • Menu (0 ou 1 ; s'affiche en tant qu'enfant du bouton qui prend en charge le modèle ExpandCollapse)

    • MenuItem (1 à plusieurs)

SplitButton

  • MenuItem (1 à plusieurs)

Propriétés UI Automation requises

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 bouton partagé. 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

Consulter les remarques.

La valeur de cette propriété doit être unique dans tous les contrôles d'une application.

BoundingRectangleProperty

Consulter les remarques.

Le rectangle le plus éloigné qui contient l'ensemble du contrôle.

ClickablePointProperty

Consulter les remarques.

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 recherche spécialisé, vous devez substituer et fournir un point interactif.

IsKeyboardFocusableProperty

Consulter les remarques.

Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.

NameProperty

"Précédent"

Le nom du contrôle bouton partagé est affiché sur le bouton.

LabeledByProperty

Null

Les contrôles bouton partagé 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

Consulter les remarques.

Le texte d'aide peut indiquer le résultat de l'activation du bouton partagé, qui contient en général le même type d'informations que celles présentées dans une info-bulle.

IsContentElementProperty

True

Le contrôle bouton partagé contient des informations pour l'utilisateur final.

IsControlElementProperty

True

Le contrôle bouton partagé est visible à l'utilisateur final.

Modèles de contrôle d'UI Automation requis

Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par les contrôles 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

Prise en charge

Remarques

IInvokeProvider

Obligatoire

Les boutons partagés ont toujours une action par défaut associée à Invoke.

IExpandCollapseProvider

Obligatoire

Les boutons partagés ont toujours la possibilité de développer une liste d'options.

Événements d'UI Automation requis

Le tableau suivant répertorie les événements UI Automation requis afin d'être pris en charge par tous les contrôles bouton partagé. Pour plus d'informations sur les événements, consultez Vue d'ensemble des événements UI Automation.

Événement UI Automation

Prise en charge

Remarques

InvokedEvent

Obligatoire

Aucun

Événement de modification de propriété BoundingRectangleProperty.

Obligatoire

Aucun

Événement de modification de propriété IsOffscreenProperty.

Obligatoire

Aucun

Événement de modification de propriété IsEnabledProperty.

Obligatoire

Aucun

Événement de modification de propriété ExpandCollapseStateProperty.

Obligatoire

Aucun

AutomationFocusChangedEvent

Obligatoire

Aucun

StructureChangedEvent

Obligatoire

Aucun

Exemple de contrôle SplitButton

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

Bouton Fractionner

Les affichages de contrôle et de contenu de l'arborescence d'UI Automation relatifs au contrôle de grille de données et de bouton partagé apparaissent ci-dessous. Les modèles de contrôle de chaque élément Automation sont mis entre parenthèses.

Arborescence UI Automation - Affichage de contrôle

Arborescence UI Automation - Affichage du contenu

  • SplitButton "Name" (Invoke, ExpandCollapse)

  • Button "More options" (Invoke)

    • Menu

    • MenuItem

  • SplitButton "Name" (Invoke, ExpandCollapse)

  • Button "More options" (Invoke)

    • Menu

    • MenuItem

Voir aussi

Référence

SplitButton

Concepts

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

Vue d'ensemble d'UI Automation