Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Nota:
Esta documentación está pensada para desarrolladores de .NET Framework que desean usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para obtener la información más reciente sobre la automatización de la interfaz de usuario, consulte API de Windows Automation: Automatización de la interfaz de usuario.
En este tema se proporciona información sobre la compatibilidad de automatización de la interfaz de usuario con el tipo de control Header. En automatización de la interfaz de usuario, un tipo de control es un conjunto de condiciones que un control debe cumplir para poder usar la ControlTypeProperty propiedad . Las condiciones incluyen directrices específicas para la estructura de árboles de automatización de la interfaz de usuario, los valores de propiedad y los patrones de control de automatización de la interfaz de usuario.
El control de encabezado proporciona un contenedor visual para las etiquetas de las filas o columnas de información.
En las secciones siguientes se define la estructura de árbol de automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el tipo de control Header. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de encabezado, ya sea Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Estructura de árbol de automatización de la interfaz de usuario necesaria
En la tabla siguiente se muestra la vista de control y la vista de contenido del árbol de automatización de la interfaz de usuario que pertenece a los controles de encabezado y se describe lo que se puede contener en cada vista. Para obtener más información sobre el árbol de automatización de la interfaz de usuario, consulte Introducción al árbol de automatización de la interfaz de usuario.
| Vista de control | Vista de contenido |
|---|---|
| Cabecera - HeaderItem (1 o más) |
Ninguno |
Los controles de encabezado siempre tienen 1 o más elementos secundarios en la vista de control del árbol de UI Automation.
Los controles de encabezado tienen cero elementos secundarios en la vista de contenido del árbol de automatización de la interfaz de usuario.
Propiedades necesarias de automatización de la interfaz de usuario
En la tabla siguiente se enumeran las propiedades de automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles de encabezado. Para obtener más información sobre las propiedades de automatización de la interfaz de usuario, consulte Propiedades de automatización de la interfaz de usuario para clientes.
| Ui Automation (propiedad) | Importancia | Notas |
|---|---|---|
| AutomationIdProperty | Vea las notas. | El valor de esta propiedad debe ser único en todos los controles de una aplicación. |
| BoundingRectangleProperty | Vea las notas. | Rectángulo más externo que contiene todo el control. |
| ClickablePointProperty | Vea las notas. | Se admite si hay un rectángulo delimitador. Si no todos los puntos que se encuentran dentro del rectángulo delimitador son seleccionables, y realiza pruebas de aciertos especializadas, invalide y ofrezca un punto en el que hacer clic. |
| IsKeyboardFocusableProperty | Vea las notas. | Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
| NameProperty | Vea las notas. | El control de encabezado necesita un nombre si hay más de un encabezado de fila o más de un encabezado de columna. Esto identifica la información dentro del encabezado. |
| LabeledByProperty |
Null. |
Los controles de encabezado no tienen una etiqueta estática. |
| ControlTypeProperty | Cabecera | Este valor es el mismo para todos los marcos de interfaz de usuario. |
| LocalizedControlTypeProperty | "encabezado" | Este valor es el mismo para todos los marcos de interfaz de usuario. |
| OrientationProperty | Horizontal | El valor de esta propiedad expone la posición del control de encabezado, ya sea un encabezado de fila o un encabezado de columna. |
| IsContentElementProperty | Falso | El control de encabezado no se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario. |
| IsControlElementProperty | Cierto | El control de encabezado siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario. |
Patrones de control de automatización de la interfaz de usuario necesarios
En la tabla siguiente se enumeran los patrones de control de automatización de la interfaz de usuario necesarios para ser compatibles con todos los controles de encabezado. Para obtener más información sobre los patrones de control, consulte Introducción a los patrones de control de automatización de la interfaz de usuario.
| Patrón de control | Apoyo | Notas |
|---|---|---|
| ITransformProvider | Depende | Implemente este patrón de control si se puede cambiar el tamaño del control de encabezado. |
Eventos necesarios de automatización de la interfaz de usuario
En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario necesarios para ser compatibles con todos los controles de encabezado. Para obtener más información sobre los eventos, consulte ui Automation Events Overview.
| Evento de automatización de la interfaz de usuario | Apoyo | Notas |
|---|---|---|
| Evento de cambio de propiedad BoundingRectangleProperty. | Obligatorio | Ninguno |
| Evento de cambio de propiedad IsOffscreenProperty. | Obligatorio | Ninguno |
| Evento de cambio de propiedad IsEnabledProperty. | Obligatorio | Ninguno |
| AutomationFocusChangedEvent | Obligatorio | Ninguno |
| StructureChangedEvent | Obligatorio | Ninguno |
Consulte también
- Header
- Introducción a los tipos de control de automatización de la interfaz de usuario de
- información general de automatización de la interfaz de usuario de