Поддержка автоматизированного пользовательского интерфейса для типа элемента управления Document
Примечание.
Эта документация предназначена для разработчиков .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 | См. примечания. | Элемент управления "Документ" обычно получает свои имена из имени файла, из которого загружается документ. Оно часто отображается в заголовке, содержащем окна или рамки. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления документами. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IScrollProvider | Зависит | Элемент управления "Документ" может занимать, превышающую область просмотра. Если содержимое может прокручиваться, этот элемент управления должен поддерживать шаблон элемента управления Scroll. |
| ITextProvider | Обязательное поле | Элемент управления "Документ" может занимать, превышающую область просмотра. Если содержимое может прокручиваться, этот элемент управления должен поддерживать шаблон элемента управления Scroll. |
| IValueProvider | Никогда | Элемент управления "Документ" не поддерживает этот шаблон элемента управления, поскольку содержимое элемента управления часто занимает несколько страниц. Клиенты автоматизации пользовательского интерфейса должны использовать TextPattern для получения текстовых сведений о документе. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления документами. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| AutomationFocusChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваHorizontallyScrollableProperty | Обязательное поле | нет |
| Событие изменения свойстваHorizontalScrollPercentProperty | Обязательное поле | нет |
| Событие изменения свойстваHorizontalViewSizeProperty | Обязательное поле | нет |
| Событие изменения свойстваVerticalScrollPercentProperty | Обязательное поле | нет |
| Событие изменения свойстваVerticallyScrollableProperty | Обязательное поле | нет |
| Событие изменения свойстваVerticalViewSizeProperty | Обязательное поле | нет |
| InvalidatedEvent | Зависит | Если элемент управления поддерживает шаблон Selection, то он должен поддерживать данное событие. |
| TextSelectionChangedEvent | Обязательное поле | нет |
| TextChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваValueProperty | Никогда | нет |