Partager via

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

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 la prise en charge d’UI Automation pour le type de contrôle Hyperlink. 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.

Les contrôles de lien hypertexte permettent à un utilisateur de naviguer dans une page, d’une page à une autre et d’ouvrir des fenêtres.

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 Hyperlink. Les exigences UI Automation s’appliquent à tous les contrôles de lien hypertexte, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre la vue de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de liens hypertexte 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
Lien hypertexte Lien hypertexte

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 le type de contrôle Hyperlink. 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 Consultez les notes. Le nom du contrôle de lien hypertexte est le texte affiché à l’écran comme souligné.
ClickablePointProperty Consultez les notes. Le point cliquable du contrôle lien hypertexte doit être un point qui lance le lien hypertexte en cliquant avec un pointeur de souris.
LabeledByProperty Consultez les notes. S’il existe une étiquette de texte statique, cette propriété doit exposer une référence à ce contrôle.
ControlTypeProperty Lien hypertexte Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « lien hypertexte » Chaîne localisée correspondant au type de contrôle Hyperlink.
IsContentElementProperty Vrai Le contrôle de lien hypertexte est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
IsControlElementProperty Vrai Le contrôle de lien hypertexte est toujours inclus dans la vue de contrôle de l’arborescence UI Automation.

Modèles et propriétés de contrôle UI Automation 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 lien hypertexte. 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 Remarques
IInvokeProvider Oui Tous les contrôles de lien hypertexte doivent prendre en charge le modèle Invoke.
IValueProvider Dépend Les contrôles de lien hypertexte doivent prendre en charge le modèle de contrôle Valeur lorsque le lien contient des informations utilisables et significatives pour l’utilisateur.
Value Par exemple, "https://www...." Une URL pour une adresse Internet ou Intranet est un exemple de lien hypertexte qui contient des informations significatives pour l’utilisateur. Toutefois, un lien programmatique est significatif uniquement pour une application et n’est pas recommandé pour la propriété Value.

É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 lien hypertexte. 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
AutomationFocusChangedEvent Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun

Voir aussi