Partager via

Type de contrôle Lien hypertexte

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

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 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 dans lesquels l’infrastructure/la plateforme d’interface utilisateur intègre la prise en charge d’UI Automation pour les types de contrôles et les modèles de contrôle.

Cette rubrique contient les sections suivantes.

Structure d’arborescence classique

Le tableau suivant illustre un contrôle et une vue de contenu typiques 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.

Vue contrôle Affichage de contenu
  • Hyperlien
  • Hyperlien

 

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 les propriétés UI Automation, consultez Récupération des propriétés à partir d’UI Automation Elements.

UI Automation, propriété Valeur Notes
UIA_AutomationIdPropertyId Consultez les notes. La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
UIA_BoundingRectanglePropertyId Consultez les notes. Rectangle le plus externe qui contient l’ensemble du contrôle.
UIA_ClickablePointPropertyId 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.
UIA_ControlTypePropertyId lien hypertexte
UIA_IsContentElementPropertyId VRAI Le contrôle de lien hypertexte est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId VRAI Le contrôle de lien hypertexte est toujours inclus dans la vue de contrôle de l’arborescence UI Automation.
UIA_IsKeyboardFocusablePropertyId Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
UIA_LabeledByPropertyId Consultez les notes. S’il existe une étiquette de texte statique, cette propriété doit exposer une référence à ce contrôle.
UIA_LocalizedControlTypePropertyId Consultez les notes. Chaîne localisée correspondant au type de contrôle Hyperlink. La valeur par défaut est « lien hypertexte » pour en-US ou l’anglais (États-Unis).
UIA_NamePropertyId Consultez les notes. 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 requis pour prendre en charge 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 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 est significatif uniquement 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 requis pour prendre en charge 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 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

 

Remarques

Le type de contrôle Hyperlink doit être appliqué uniquement à un objet qui, lorsqu’il est cliqué, provoque la navigation ; elle ne doit pas être appliquée 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 Lien hypertexte . 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 Hyperlink Hyperlink, 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.

conceptuelle

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

Vue d’ensemble UI Automation

 

 

  • Last updated on