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

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

Замечание

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

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

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

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Document. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления документами, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

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

-Меняется		 Документ

-Меняется

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

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

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

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

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

Шаблон элемента управления Поддержка Примечания.
IScrollProvider Зависит Элемент управления документами может охватывать больше этого диапазона окна просмотра. Элемент управления должен поддерживать шаблон управления Scroll, если содержимое доступно для прокрутки.
ITextProvider Обязательно Элемент управления документами может охватывать больше этого диапазона окна просмотра. Элемент управления должен поддерживать шаблон управления Scroll, если содержимое доступно для прокрутки.
IValueProvider Никогда Элемент управления документа не поддерживает этот шаблон управления, так как содержимое элемента управления часто охватывает несколько страниц. Клиенты автоматизации пользовательского интерфейса должны использовать TextPattern для получения текстовых сведений о документе.

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
AutomationFocusChangedEvent Обязательно Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует
HorizontallyScrollableProperty событие изменения свойства. Обязательно Отсутствует
HorizontalScrollPercentProperty событие изменения свойства. Обязательно Отсутствует
HorizontalViewSizeProperty событие изменения свойства. Обязательно Отсутствует
VerticalScrollPercentProperty событие изменения свойства. Обязательно Отсутствует
VerticallyScrollableProperty событие изменения свойства. Обязательно Отсутствует
VerticalViewSizeProperty событие изменения свойства. Обязательно Отсутствует
InvalidatedEvent Зависит Если элемент управления поддерживает шаблон элемента управления Selection, он должен поддерживать это событие.
TextSelectionChangedEvent Обязательно Отсутствует
TextChangedEvent Обязательно Отсутствует
ValueProperty событие изменения свойства. Никогда Отсутствует

См. также

  • Last updated on