Поддержка модели автоматизации пользовательского интерфейса для типа элемента управления Calendar
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса типа элемента управления Calendar. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, значениям свойств модель автоматизации пользовательского интерфейса, шаблонам элементов управления и модель автоматизации пользовательского интерфейса события.
С помощью элементов управления "Календарь" пользователь может легко определить дату и выбрать другие даты.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления Calendar. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления календарем, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления календарем и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
Календарь
|
Календарь — ListItem (количество зависит от количества отображаемых дней) |
Элементы управления "Календарь" могут быть представлены в пользовательском интерфейсе во многих различных формах. Единственными элементами управления, которые должны находиться в представлении элемента управления дерева модель автоматизации пользовательского интерфейса, являются сетка данных, заголовок, элемент управления заголовком и элементом списка.
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно важно для элементов управления календарем. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| ControlTypeProperty | Календарь | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| IsContentElementProperty | Истина | Элемент управления календарем всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Элемент управления календарем всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| LabeledByProperty | См. примечания. | Метка элемента управления "Документ". Как правило, используется заголовок документа. |
| LocalizedControlTypeProperty | "календарь" | Локализованная строка, соответствующая типу элемента управления Calendar. |
| NameProperty | См. примечания. | Элемент управления "Календарь" обычно получает свое имя от текущей даты. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления календаря. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка | Примечания. |
|---|---|---|
| IGridProvider | Да | Элемент управления "Календарь" всегда поддерживает шаблон Grid, поскольку дни месяца являются элементами, в которых возможна пространственная навигация. |
| IScrollProvider | Зависит | Большинство элементов управления "Календарь" поддерживают постраничное перелистывание представления. Шаблон Scroll рекомендуется использовать для поддержки постраничной навигации. |
| ISelectionProvider | Зависит | Большинство элементов управления "Календарь" сохраняет определенный день, месяц или год в качестве выбора вложенного элемента. В одних календарях можно выбирать несколько вариантов, в других — только один. |
| ITableProvider | Да | Элемент управления "Календарь" всегда имеет заголовок в своем поддереве для дней недели, поэтому должен поддерживаться шаблон Table. |
| IValueProvider | No | Шаблон элемента управления Value для элементов управления "Календарь" не требуется, так как вы не можете задавать значение непосредственно в элементе управления. Если с элементом управления связана определенная дата, эти сведения должны предоставляться шаблоном элемента управления Selection. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления календарем. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| AutomationFocusChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| LayoutInvalidatedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваCurrentViewProperty | Зависит | нет |
| Событие изменения свойстваHorizontallyScrollableProperty | Зависит | Если элемент управления поддерживает шаблон Scroll, то он должен поддерживать данное событие. |
| Событие изменения свойстваHorizontalScrollPercentProperty | Зависит | Если элемент управления поддерживает шаблон Scroll, то он должен поддерживать данное событие. |
| Событие изменения свойстваHorizontalViewSizeProperty | Зависит | Если элемент управления поддерживает шаблон Scroll, то он должен поддерживать данное событие. |
| Событие изменения свойстваVerticalScrollPercentProperty | Зависит | Если элемент управления поддерживает шаблон Scroll, то он должен поддерживать данное событие. |
| Событие изменения свойстваVerticallyScrollableProperty | Зависит | Если элемент управления поддерживает шаблон Scroll, то он должен поддерживать данное событие. |
| Событие изменения свойстваVerticalViewSizeProperty | Зависит | Если элемент управления поддерживает шаблон Scroll, то он должен поддерживать данное событие. |
| InvalidatedEvent | Обязательное поле | нет |