Тип элемента управления Calendar
В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления календаря. Элемент управления календарем позволяет пользователю легко определить дату и выбрать другие даты.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Calendar. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления календаря, где платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- обязательные шаблоны элементов управления
- обязательные события
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления календарем и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
Представление элемента управления | Представление содержимого |
---|---|
|
|
Элементы управления календарем можно представить в различных формах в пользовательском интерфейсе. Единственными элементами управления, которые гарантированно находятся в представлении элемента управления дерева автоматизации пользовательского интерфейса, являются сетка данных, заголовок, элемент управления заголовком и элементом списка.
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которого особенно важно для типа элемента управления "Календарь календаря". Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
---|---|---|
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 |
Связанные разделы
-
концептуальные
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса