Compartir a través de

Tipo de control calendar

  • Artículo

En este tema se proporciona información sobre la compatibilidad de Automatización de la interfaz de usuario de Microsoft para el tipo de control calendario de. Un control de calendario permite al usuario determinar fácilmente la fecha y seleccionar otras fechas.

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 calendario de. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de calendario en los que la plataforma o plataforma de la interfaz de usuario integra la compatibilidad de automatización de la interfaz de usuario con los tipos de control y los patrones de control.

Este tema contiene las secciones siguientes.

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

 

Los controles de calendario se pueden representar en muchos formularios 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 de 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, consulte Recuperar propiedades de elementos de automatización de la interfaz de usuario.

Ui Automation (propiedad) 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. Rectángulo más externo que contiene todo el control.
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, invalida y proporciona un punto en el que se puede hacer clic.
UIA_ControlTypePropertyId calendario Este valor es el mismo para todos los marcos de interfaz de usuario.
UIA_IsContentElementPropertyId VERDADERO El control de calendario siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario.
UIA_IsControlElementPropertyId VERDADERO 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 usa 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 de la fecha actual.

 

Patrones de control 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 calendario. 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/propiedad pattern Compatibilidad/valor Notas
IGridProvider Obligatorio El control de calendario siempre admite el patrón de control de Grid porque los días dentro 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 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 de selección.
de 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, la información debe proporcionarse mediante el patrón de control selección de.

 

Eventos necesarios

En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que son necesarios para admitir los controles de calendario. Para obtener más información sobre los eventos, consulte 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 propiedadIsEnabled, 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 propiedadCurrentView del patrón de control de 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 de

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