Tipo de control Calendar
En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control Calendar. Un control de calendario permite al usuario determinar fácilmente la fecha y seleccionar otras fechas.
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 Calendar. Los requisitos de Automatización de la interfaz de usuario se aplican a todos los controles de calendario en los que el marco o la plataforma de la interfaz de usuario se 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 pertinentes
- Patrones de control necesarios
- Eventos necesarios
- 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 calendario 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 |
|---|---|
|
|
Los controles de calendario se pueden representar de muchas formas diferentes dentro de la interfaz de usuario. Los únicos controles garantizados para estar en la vista de control del árbol de Automatización de la interfaz de usuario son los controles de cuadrícula de datos, encabezado, elemento de encabezado y elemento de lista.
Propiedades pertinentes
En la tabla siguiente se enumeran las propiedades Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para el tipo de control Calendar. 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 entre todos los elementos del mismo nivel en la vista sin procesar del árbol de Automatización de la interfaz de usuario. |
| UIA_BoundingRectanglePropertyId | Vea las notas. | El rectángulo exterior que contiene el control completo. |
| UIA_ClickablePointPropertyId | Vea las notas. | Se admite si hay un rectángulo delimitador. Si no se puede hacer clic en todos los puntos del rectángulo delimitador y el elemento realiza pruebas de posicionamiento especializadas, invalide y proporcione un punto en el que se pueda hacer clic. |
| UIA_ControlTypePropertyId | Calendario | Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario. |
| UIA_IsContentElementPropertyId | TRUE | El control de calendario siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario. |
| UIA_IsControlElementPropertyId | TRUE | El control de calendario 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. | El valor de esta propiedad debe ser la etiqueta del control de documento. Normalmente, se utiliza el título del documento. |
| UIA_LocalizedControlTypePropertyId | Vea las notas. | Cadena localizada correspondiente al tipo de control Calendar . El valor predeterminado es "calendar" para en-US o inglés (Estados Unidos). |
| UIA_NamePropertyId | Vea las notas. | El control de calendario normalmente obtiene su nombre a partir de la fecha actual. |
Patrones de control necesarios
En la tabla siguiente se muestran los patrones de control de automatización de la interfaz de usuario necesarios para que todos los controles de calendario los admitan. 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 |
|---|---|---|
| IGridProvider | Obligatorio | El control de calendario siempre admite el patrón de control Grid porque los días de un mes son elementos que se pueden navegar espacialmente. |
| IScrollProvider | Depende | La mayoría de los controles de calendario admiten voltear la vista por página. Se recomienda el patrón de control Scroll para admitir la navegación por paginación. |
| ISelectionProvider | Depende | La mayoría de los controles de calendario conservan un día, mes o año específicos como una selección del subelemento. Algunos calendarios son multi-selectable y otros solo seleccionables. El control Calendario con subelementos seleccionables debe admitir el patrón de control Selección . |
| ITableProvider | Obligatorio | Dado que el control de calendario siempre tiene un encabezado dentro de su subárbol durante los días de la semana, se debe admitir el patrón de control Table . |
| IValueProvider | No | El patrón de control Value no es necesario para los controles de calendario porque el elemento no puede establecer el valor directamente en el control. Si una fecha específica está asociada al control , el patrón de control Selección debe proporcionar la información. |
Eventos necesarios
En la tabla siguiente se enumeran los eventos de Automatización de la interfaz de usuario que se requieren controles de calendario 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_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_LayoutInvalidatedEventId | |
| UIA_MultipleViewCurrentViewPropertyId evento de cambio de propiedad. | Si el control admite la propiedad CurrentView del patrón de control MultipleView , debe admitir este evento. |
| UIA_StructureChangedEventId | |
| UIA_ScrollHorizontallyScrollablePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollHorizontalViewSizePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollVerticalScrollPercentPropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollVerticallyScrollablePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollVerticalViewSizePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_Selection_InvalidatedEventId |
Temas relacionados
-
Conceptual