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

Поддержка автоматизации пользовательского интерфейса для типа элемента управления "Календарь"

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

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

Элементы управления календарем позволяют пользователю легко определить дату и выбрать другие даты.

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Calendar. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления календарем, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

Вид управления Просмотр содержимого
Календарь

  • DataGrid

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

— ListItem (количество зависит от количества отображаемых дней)

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

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания.
AutomationIdProperty См. заметки. Значение этого свойства должно быть уникальным для всех элементов управления в приложении.
BoundingRectangleProperty См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не на каждую точку в ограничивающем прямоугольнике можно щелкнуть, и вы проводите специализированную проверку на попадание, то переопределите и укажите точку, на которую можно щелкнуть.
ControlTypeProperty Календарь Это значение одинаково для всех платформ пользовательского интерфейса.
IsContentElementProperty Верно Элемент управления календарем всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса.
IsControlElementProperty Верно Элемент управления календарем всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
IsKeyboardFocusableProperty См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
LabeledByProperty См. заметки. Метка контроля документа. Обычно используется название документа.
LocalizedControlTypeProperty "календарь" Локализованная строка, соответствующая типу элемента управления Calendar.
NameProperty См. заметки. Элемент управления календари обычно берет название из даты текущего дня.

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

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

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

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
AutomationFocusChangedEvent Обязательно Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
LayoutInvalidatedEvent Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует
CurrentViewProperty событие изменения свойства. Зависит Отсутствует
HorizontallyScrollableProperty событие изменения свойства. Зависит Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
HorizontalScrollPercentProperty событие изменения свойства. Зависит Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
HorizontalViewSizeProperty событие изменения свойства. Зависит Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
VerticalScrollPercentProperty событие изменения свойства. Зависит Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
VerticallyScrollableProperty событие изменения свойства. Зависит Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
VerticalViewSizeProperty событие изменения свойства. Зависит Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
InvalidatedEvent Обязательно Отсутствует

См. также