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

Тип элемента управления документами

  • Статья

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

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

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

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

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

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

Представление элемента управления Представление содержимого
  • Документ
    • Меняется
  • Документ
    • Меняется

 

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. заметки. В документе есть нажмичная точка, которая приведет к тому, что документ одного из его элементов в контейнере документов будет иметь фокус.
UIA_ControlTypePropertyId документ
UIA_IsContentElementPropertyId ИСТИННЫЙ Элемент управления документами всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId ИСТИННЫЙ Элемент управления документа всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId См. заметки. Значение этого свойства должно быть меткой элемента управления документами. Обычно используется название документа.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления document Document. Значение по умолчанию — document для en-US или английского (США).
UIA_NamePropertyId См. заметки. Элемент управления документа обычно получает имя из имени файла, из который он загружается. Это часто отображается в окне или заголовке кадра.

 

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

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

Управление шаблоном или свойством шаблонов Поддержка и значение Примечания
IScrollProvider Зависит Элемент управления документами может охватывать больше этого диапазона окна просмотра. Элемент управления должен поддерживать шаблон элемента управления прокрутки, если содержимое доступно для прокрутки.
ITextProvider Обязательно Все элементы управления документами должны поддерживать шаблон элемента управления Text.
IValueProvider Зависит Хотя клиенты службы автоматизации пользовательского интерфейса могут использовать IUIAutomationTextPattern для получения текстовых сведений о документе, им нужен шаблон элемента управления значение, чтобы задать внутреннее значение. Простая запись текста возможна только с помощью шаблона элемента управления "Значение".

 

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

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_StructureChangedEventId
событие UIA_ScrollHorizontallyScrollablePropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollHorizontalScrollPercentPropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_ScrollHorizontalViewSizePropertyId событие, измененное свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollVerticallyScrollablePropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollVerticalScrollPercentPropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_Selection_InvalidatedEventId Если элемент управления поддерживает шаблон элемента управления selection, он должен поддерживать это событие.
UIA_Text_TextSelectionChangedEventId
UIA_Text_TextChangedEventId
UIA_ValueValuePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон Value, он должен поддерживать это событие.

 

концептуальные

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

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