Tipo de control Hyperlink
En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control Hyperlink.
Los controles de hipervínculo crean vínculos que permiten a los usuarios navegar dentro de la misma página o de una página a otra.
En las secciones siguientes se definen la estructura de árbol Automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el tipo de control Hyperlink. Los requisitos de Automatización de la interfaz de usuario se aplican a todos los controles de hipervínculo en los que el marco o plataforma de la interfaz de usuario integra Automatización de la interfaz de usuario compatibilidad con los tipos de control y los patrones de control.
En este tema se incluyen las siguientes secciones.
- Estructura de árbol típica
- Propiedades relevantes
- Patrones de control necesarios
- Eventos necesarios
- Comentarios:
- Temas relacionados
Estructura de árbol típica
En la tabla siguiente se muestra un control típico y una vista de contenido del árbol de Automatización de la interfaz de usuario que pertenece a los controles de hipervínculo y se describe lo que se puede contener en cada vista. Para más información sobre el árbol de UI Automation, vea Información general del árbol de UI Automation.
| Vista de control | Vista de contenido |
|---|---|
|
|
Propiedades relevantes
En la tabla siguiente se enumeran las propiedades Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles de hipervínculo. Para obtener más información sobre las propiedades de Automatización de la interfaz de usuario, vea Recuperar propiedades de Automatización de la interfaz de usuario Elements.
| Propiedad de automatización de interfaz de usuario | Valor | Notas |
|---|---|---|
| UIA_AutomationIdPropertyId | Vea las notas. | El valor de esta propiedad debe ser único en todos los controles de una aplicación. |
| UIA_BoundingRectanglePropertyId | Vea las notas. | El rectángulo exterior que contiene el control completo. |
| UIA_ClickablePointPropertyId | Vea las notas. | El punto que se puede hacer clic en el control de hipervínculo debe ser un punto que inicie el hipervínculo si se hace clic con un puntero del mouse. |
| UIA_ControlTypePropertyId | Hipervínculo | |
| UIA_IsContentElementPropertyId | TRUE | El control de hipervínculo siempre se incluye en la vista de contenido del árbol de Automatización de la interfaz de usuario. |
| UIA_IsControlElementPropertyId | TRUE | El control de hipervínculo siempre se incluye en la vista de control del árbol de Automatización de la interfaz de usuario. |
| UIA_IsKeyboardFocusablePropertyId | Vea las notas. | Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
| UIA_LabeledByPropertyId | Vea las notas. | Si hay una etiqueta de texto estático, esta propiedad debe exponer una referencia a ese control. |
| UIA_LocalizedControlTypePropertyId | Vea las notas. | Cadena localizada correspondiente al tipo de control Hyperlink . El valor predeterminado es "hyperlink" para en-US o inglés (Estados Unidos). |
| UIA_NamePropertyId | Vea las notas. | El nombre del control de hipervínculo es el texto que se muestra en la pantalla como subrayado. |
Patrones de control necesarios
En la tabla siguiente se enumeran los patrones de control Automatización de la interfaz de usuario que los controles de hipervínculo son necesarios para admitir. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.
| Patrón de control/Propiedad de patrón | Soporte técnico/valor | Notas |
|---|---|---|
| IInvokeProvider | Obligatorio | Todos los controles de hipervínculo deben admitir el patrón de control Invoke . |
| IValueProvider | Depende | Los controles de hipervínculo deben admitir el patrón de control Value cuando el vínculo contiene información que se puede usar y que es significativa para el usuario. |
| Value | Por ejemplo, "https://www..." | Una dirección URL de una dirección de Internet o intranet es un ejemplo de un hipervínculo que contiene información significativa para el usuario. Sin embargo, un vínculo mediante programación solo es significativo para una aplicación y no se recomienda para la propiedad Value . |
Eventos necesarios
En la tabla siguiente se enumeran los eventos Automatización de la interfaz de usuario que los controles de hipervínculo son necesarios para admitir. Para más información sobre los eventos, vea UI Automation Events Overview.
| Evento de Automatización de la interfaz de usuario | Notas |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento de cambio de propiedad. | |
| UIA_Invoke_InvokedEventId | |
| UIA_IsEnabledPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsEnabled , debe admitir este evento. |
| UIA_IsOffscreenPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsOffscreen , debe admitir este evento. |
| UIA_StructureChangedEventId |
Observaciones
El tipo de control Hyperlink solo se debe aplicar a un objeto que, cuando se hace clic, hace que se produzca la navegación; no se debe aplicar al contenedor del hipervínculo. Por ejemplo, solo los "puntos activos" que se pueden hacer clic dentro de un mapa de imágenes deben tener el tipo de control Hyperlink . Lo mismo sucede con los hipervínculos de un campo de texto o contenedor de documentos. En este caso, solo el texto o la imagen del hipervínculo deben tener el tipo de control Hyperlink , no el contenedor.
El patrón de control Text es ideal para admitir hipervínculos incrustados en elementos de texto o documento.
Temas relacionados
-
Conceptual