Type de contrôle Hyperlink

  • Article

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

Les contrôles de lien hypertexte créent des liens qui permettent aux utilisateurs de naviguer dans la même page ou d’une page à une autre.

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

Cette rubrique contient les sections suivantes.

Arborescence standard

Le tableau suivant illustre une vue de contrôle et de contenu classique de l’arborescence UI Automation qui se rapporte aux contrôles de lien 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.

Affichage de contrôle Affichage de contenu
  • Hyperlink
  • Hyperlink

 

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 lien hypertexte. Pour plus d’informations sur UI Automation propriétés, consultez Récupération de propriétés à partir d’éléments UI Automation.

Propriété UI Automation Valeur Notes
UIA_AutomationIdPropertyId Consultez les remarques. La valeur de cette propriété doit être unique dans tous les contrôles d’une application.
UIA_BoundingRectanglePropertyId Consultez les remarques. Rectangle externe qui contient l’ensemble du contrôle.
UIA_ClickablePointPropertyId Consultez les remarques. Le point cliquable du contrôle de lien hypertexte doit être un point qui lance le lien hypertexte s’il est cliqué avec un pointeur de souris.
UIA_ControlTypePropertyId Lien hypertexte
UIA_IsContentElementPropertyId true Le contrôle de lien hypertexte est toujours inclus dans l’affichage de contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId true Le contrôle de barre de progression est toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation.
UIA_IsKeyboardFocusablePropertyId Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
UIA_LabeledByPropertyId Consultez les remarques. S’il existe une étiquette de texte statique, cette propriété doit exposer une référence à ce contrôle.
UIA_LocalizedControlTypePropertyId Consultez les remarques. Chaîne localisée correspondant au type de contrôle Hyperlink . La valeur par défaut est « hyperlink » pour en-US ou english (États-Unis).
UIA_NamePropertyId Consultez les remarques. Le nom du contrôle de lien hypertexte est le texte affiché à l’écran comme souligné.

 

Modèles de contrôle requis

Le tableau suivant répertorie les modèles de contrôle UI Automation que les contrôles de lien hypertexte doivent prendre en charge. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.

Modèle de contrôle/Propriété de modèle Prise en charge/valeur Notes
IInvokeProvider Obligatoire Tous les contrôles de lien hypertexte doivent prendre en charge le modèle de contrô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.
Valeur 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 n’est significatif que pour une application et n’est pas recommandé pour la propriété Value .

 

Événements obligatoires

Le tableau suivant répertorie les événements UI Automation que les contrôles de lien hypertexte doivent prendre en charge. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.

Événement UI Automation Notes
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId’événement de modification de propriété.
UIA_Invoke_InvokedEventId
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_StructureChangedEventId

 

Notes

Le type de contrôle Hyperlink doit être appliqué uniquement à un objet qui, lorsqu’on clique dessus, provoque la navigation ; il ne doit pas être appliqué au conteneur du lien hypertexte. Par exemple, seuls les « points chauds » cliquables à l’intérieur d’une carte d’images doivent avoir le type de contrôle Hyperlink . Il en va de même pour les liens hypertexte dans un champ de texte ou un conteneur de documents. Dans ce cas, seul le texte ou l’image du lien hypertexte doit avoir le type de contrôle Lien hypertexte , et non le conteneur.

Le modèle de contrôle Texte est idéal pour prendre en charge les liens hypertexte incorporés dans des éléments de texte ou de document.

Conceptuel

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

Vue d'ensemble d'UI Automation