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

Статья
08/11/2011

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

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

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

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

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

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

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

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

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

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

Календарь

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

Календарь

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

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

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

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

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

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

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

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

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

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

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

См. также

Ссылки

Calendar

Основные понятия

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

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

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