Type de contrôle Hyperlink
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
- Propriétés pertinentes
- Modèles de contrôle requis
- Événements obligatoires
- Remarques
- Rubriques connexes
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 |
|---|---|
|
|
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.
Rubriques connexes