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

  • Статья

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

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

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

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

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

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

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

 

Релевантные свойства

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

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

 

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

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

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

 

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

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

Событие модель автоматизации пользовательского интерфейса Примечания
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 событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления "Значение" , он должен поддерживать это событие.

 

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

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

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