Поделиться через

Тип элемента управления Calendar

  • Статья

В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления календаря. Элемент управления календарем позволяет пользователю легко определить дату и выбрать другие даты.

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Calendar. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления календаря, где платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.

В этом разделе содержатся следующие разделы.

Типичная структура дерева

В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления календарем и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.

Представление элемента управления Представление содержимого
  • Календарь
    • DataGrid
      • Заголовок (0 или 1)
        • HeaderItem (0 или 7, количество зависит от количества дней, отображаемых в столбцах)
      • ListItem (количество зависит от количества отображаемых дней)
      • Кнопка (0 или 2; для представления календаря на страницы)
  • Календарь
    • ListItem (количество зависит от количества отображаемых дней)

 

Элементы управления календарем можно представить в различных формах в пользовательском интерфейсе. Единственными элементами управления, которые гарантированно находятся в представлении элемента управления дерева автоматизации пользовательского интерфейса, являются сетка данных, заголовок, элемент управления заголовком и элементом списка.

Соответствующие свойства

В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которого особенно важно для типа элемента управления "Календарь календаря". Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не каждая точка в ограничивающем прямоугольнике можно щелкнуть, а элемент выполняет специализированное тестирование попаданий, переопределите и укажите точку, доступную для щелчка.
UIA_ControlTypePropertyId календаря Это значение одинаково для всех платформ пользовательского интерфейса.
UIA_IsContentElementPropertyId ИСТИННЫЙ Элемент управления календарем всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId ИСТИННЫЙ Элемент управления календарем всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId См. заметки. Значение этого свойства должно быть меткой элемента управления документами. Обычно используется название документа.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления calendar Calendar. Значение по умолчанию — calendar для en-US или английского языка (США).
UIA_NamePropertyId См. заметки. Элемент управления календаря обычно получает имя из текущей даты.

 

Обязательные шаблоны элементов управления

В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления календаря. Дополнительные сведения о шаблонах элементов управления см. в шаблонах элементов управления автоматизации пользовательского интерфейса.

Управление шаблоном или свойством шаблонов Поддержка и значение Примечания
IGridProvider Обязательно Элемент управления календаря всегда поддерживает шаблон элемента управления сетки, так как дни в течение месяца — это элементы, которые можно перемещать по пространственному пространству.
IScrollProvider Зависит Большинство элементов управления календарем поддерживают перевернутые представления по странице. Шаблон элемента управления прокрутки рекомендуется для поддержки навигации по страницам.
ISelectionProvider Зависит Большинство элементов управления календарем сохраняют определенный день, месяц или год в качестве выбора подэлемента. Некоторые календари доступны для нескольких выборок и доступны только для одного выбора. Элемент управления "Календарь" с выбранными подэлементами должен поддерживать шаблон выбора.
ITableProvider Обязательно Так как элемент управления календарем всегда содержит заголовок в поддереве в течение дней недели, необходимо поддерживать шаблон элемента управления table.
IValueProvider Нет Шаблон элемента управления value не нужен для элементов управления календарем, так как элемент не может задать значение непосредственно в элементе управления. Если с элементом управления связана определенная дата, сведения должны быть предоставлены шаблоном элемента управления selection.

 

Обязательные события

В следующей таблице перечислены события автоматизации пользовательского интерфейса, необходимые для поддержки элементов управления календарем. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_LayoutInvalidatedEventId
событие UIA_MultipleViewCurrentViewPropertyId изменено свойством. Если элемент управления поддерживает свойство CurrentView шаблона элемента управления MultipleView, оно должно поддерживать это событие.
UIA_StructureChangedEventId
событие UIA_ScrollHorizontallyScrollablePropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollHorizontalScrollPercentPropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_ScrollHorizontalViewSizePropertyId событие, измененное свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollVerticalScrollPercentPropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollVerticallyScrollablePropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_Selection_InvalidatedEventId

 

концептуальные

Общие сведения о типах элементов управления автоматизации пользовательского интерфейса

Обзор автоматизации пользовательского интерфейса