Prise en charge d'UI Automation pour le type de contrôle Button
.gif "Remarque") Remarque |
|---|
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 Button. Dans UI Automation, un type de contrôle est un ensemble de conditions qu'un contrôle doit respecter pour utiliser la propriété ControlTypeProperty. Les conditions incluent des indications spécifiques pour l'arborescence UI Automation, les valeurs de propriété UI Automation, les modèles de contrôle et les événements d'UI Automation.
Un bouton est un objet avec lequel l'utilisateur interagit pour exécuter une action ; par exemple les boutons OK et Annuler sur une boîte de dialogue. Le contrôle bouton est un contrôle simple à exposer, car il est mappé à une seule commande que l'utilisateur souhaite effectuer.
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 Button. Les spécifications UI Automation s'appliquent à tous les contrôles bouton, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou Windows Forms.
Cette rubrique comprend les sections suivantes.
- Arborescence UI Automation requise
- Propriétés UI Automation requises
- Modèles de contrôle UI Automation requis
- Événements UI Automation requis
- Rubriques connexes
Arborescence 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 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 |
|---|---|
Button
|
Button |
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 qui implémentent le type de contrôle Button (tels que les contrôles 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 |
|---|---|---|
Consulter les remarques. |
Le contrôle Button doit généralement prendre en charge une touche accélérateur pour permettre à un utilisateur final d'exécuter rapidement l'action représentée à partir du clavier. |
|
Consulter les remarques. |
La valeur de cette propriété doit être unique dans tous les contrôles d'une application. |
|
Consulter les remarques. |
Le rectangle le plus éloigné qui contient l'ensemble du contrôle. |
|
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 positionnement spécialisé, vous devez substituer et fournir un point interactif. |
|
Button |
Cette valeur est la même pour toutes les infrastructures d'interface utilisateur. |
|
Consulter les remarques. |
Le texte d'aide peut indiquer le résultat final de l'activation du bouton. Il s'agit en général du même type d'informations que celui présenté dans une info-bulle. |
|
True |
Le contrôle Button doit toujours être du contenu. |
|
True |
Le contrôle Button doit toujours être un contrôle. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Null |
Les contrôles Button sont étiquetés automatiquement par leur contenu. |
|
"button" |
Chaîne localisée correspondant au type de contrôle Button. |
|
Consulter les remarques. |
Le nom du contrôle bouton est le texte utilisé pour l'étiqueter. Chaque fois qu'une image est utilisée pour étiqueter un bouton, un texte de remplacement doit être fourni pour la propriété Name du bouton. |
Modèles de contrôle UI Automation requis
Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par tous les contrôles bouton. 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 |
|---|---|---|
Consulter les remarques. |
Tous les boutons doivent prendre en charge le modèle de contrôle Invoke ou Toggle. Invoke est pris en charge lorsque le bouton exécute une commande à la demande de l'utilisateur. Cette commande est mappée à une seule opération telle que Couper, Copier, Coller ou Supprimer. |
|
Consulter les remarques. |
Tous les boutons doivent prendre en charge le modèle de contrôle Invoke ou Toggle. Toggle est pris en charge si le bouton peut passer par une série de trois états maximum. En général, cela correspond à un commutateur marche/arrêt pour les fonctionnalités spécifiques. |
|
Consulter les remarques. |
Lorsqu'un bouton est hébergé en tant qu'enfant d'un bouton partagé, le bouton enfant peut prendre en charge le modèle ExpandCollapse au lieu du modèle Invoke ou Toggle. Le modèle ExpandCollapse peut être utilisé pour l'ouverture ou la fermeture d'un menu ou d'une autre sous-structure associée à l'élément de bouton. |
Événements UI Automation requis
Le tableau suivant répertorie les événements UI Automation qui doivent être pris en charge par tous les contrôles bouton. 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 |
|---|---|---|
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é NameProperty. |
Obligatoire |
Aucun |
Obligatoire |
Aucun |
|
Selon le cas |
Si le contrôle prend en charge le modèle de contrôle Invoke, il doit prendre en charge cet événement. |
|
Événement de modification de propriété ToggleStateProperty. |
Selon le cas |
Si le contrôle prend en charge le modèle de contrôle Toggle, il doit prendre en charge cet événement. |