Tipo de control Calendar

  • Artículo

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

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
  • Calendario
    • DataGrid
      • Header (0 o 1)
        • HeaderItem (0 o 7, cantidad depende del número de días que se muestran en las columnas)
      • ListItem (la cantidad depende del número de días que se muestren)
      • Button (0 o 2; para la paginación de la vista de calendario)
  • Calendario
    • ListItem (la cantidad depende del número de días que se muestren)

 

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

 

Conceptual

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation