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

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

В этом разделе содержатся сведения о поддержке UI Automation  типа элемента управления Document. В UI Automation тип элемента управления представляет собой набор условий, которым должен удовлетворять элемент управления, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Ссылки

Document

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

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

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