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

Тип элемента управления "Календарь"

  • Статья

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

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

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

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

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

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

 

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

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

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

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

 

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

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

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

 

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

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

Событие модель автоматизации пользовательского интерфейса Примечания
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

 

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

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

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