Поддержка автоматизации пользовательского интерфейса для типа элемента управления "Поле вода"
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса для типа элемента управления Edit. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, значениям свойств модель автоматизации пользовательского интерфейса и шаблонам элементов управления.
С помощью элементов управления "Поле ввода" пользователи могут просматривать и изменять простую строку текста без широкой поддержки форматирования.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления Edit. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления редактирования, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице показано представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, которое относится к элементам управления редактирования и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| Редактировать | Редактировать |
Элементы управления, реализующие тип элемента управления Edit, всегда будут иметь нулевые полосы прокрутки в представлении элемента управления дерева модель автоматизации пользовательского интерфейса, так как это однострочный элемент управления. В некоторых макетах одна строка текста может переноситься. Тип элемента управления Edit лучше всего подходит для хранения небольших объемов редактируемого или выбираемого текста.
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно важно для редактирования элементов управления. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Элемент управления "Поле ввода должен иметь активную точку, которая предоставляет фокус ввода в часть редактирования элемента управления, когда пользователь щелкает ее мышью. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Имя элемента управления "Поле ввода" обычно создается из статического текста метки. Если статическая текстовая метка не предусмотрена, разработчик приложения должен предоставить значение для свойства Name . Значение свойства Name никогда не должно быть текстовым содержимым элемента управления "Поле ввода". |
| LabeledByProperty | См. примечания. | Если статическая текстовая метка связана с элементом управления, то данное свойство должно предоставлять ссылку на этот элемент управления. Если элемент управления "Текст" является подкомпонентом другого элемента управления, он не будет иметь набор свойств LabeledBy . |
| ControlTypeProperty | Редактировать | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "поле ввода" | Локализованная строка, соответствующая типу элемента управления Edit. |
| IsContentElementProperty | Истина | Элемент управления редактированием всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Элемент управления редактирования всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| IsPasswordProperty | См. примечания. | Должно быть задано значение true во всех элементах управления "Поле ввода", содержащих пароли. Если элемент управления "Поле ввода" содержит пароль, то это свойство может использоваться средством чтения с экрана для определения, должны ли считываться нажатия клавиш по мере нажатия их пользователем. |
Необходимые шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления, которые должны поддерживаться всеми элементами управления "Поле ввода". Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона элемента управления | Поддержка/значение | Примечания. |
|---|---|---|
| ITextProvider | Зависит | Элементы управления "Поле ввода" должны поддерживать шаблон элемента управления Text, поскольку клиентам всегда должна быть доступна подробная текстовая информация. |
| IValueProvider | Зависит | Все элементы управления "Поле ввода", которые принимают строку, должны предоставлять шаблон Value. |
| IsReadOnly | См. примечания. | Это свойство должно быть установлено, чтобы указать, может ли элемент управления иметь значение, заданное программными средствами, его может изменять пользователь. |
| Value | См. примечания. | Это свойство будет возвращать текстовое содержимое элемента управления "Поле ввода". Если IsPasswordProperty имеет значение true, это свойство должно создавать InvalidOperationException по запросу. |
| IRangeValueProvider | Зависит | Все элементы управления "Поле ввода", принимающие числовой диапазон, должны предоставлять шаблон элемента управления Range Value. |
| Minimum | См. примечания. | Это свойство должно быть наименьшим значением, которое может быть присвоено содержимому элемента управления "Поле ввода". |
| Maximum | См. примечания. | Это свойство должно быть наибольшим значением, которое может быть присвоено содержимому элемента управления "Поле ввода". |
| SmallChange | См. примечания. | Это свойство должно указывать количество десятичных разрядов, которое может быть в значении. Если поле ввода принимает только целые значения, SmallChangeProperty должно иметь значение 1. Если поле ввода принимает значения в диапазоне от 1.0 до 2.0, то SmallChangeProperty должно иметь значение 0.1. Если поле ввода принимает значения в диапазоне от 1.00 до 2.00, то SmallChangeProperty должно иметь значение 0.001. |
| LargeChange | Null |
Это свойство не обязательно предоставлять в элементе управления "Поле ввода". |
| Value | См. примечания. | Это свойство будет указывать числовое содержимое элемента управления "Поле ввода". Если более точное значение задается клиентом модель автоматизации пользовательского интерфейса в диапазонах, указанных в Minimum и Maximum свойствах, свойство Value автоматически округляется до ближайшего принятого значения. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, необходимые для поддержки всех элементов управления редактированием. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| InvalidatedEvent | Обязательное поле | нет |
| TextSelectionChangedEvent | Обязательное поле | нет |
| TextChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваNameProperty | Обязательное поле | нет |
| Событие изменения свойстваValueProperty | Зависит | нет |
| Событие изменения свойстваHorizontallyScrollableProperty | Никогда | нет |
| Событие изменения свойстваHorizontalScrollPercentProperty | Никогда | нет |
| Событие изменения свойстваHorizontalViewSizeProperty | Никогда | нет |
| Событие изменения свойстваVerticalScrollPercentProperty | Никогда | нет |
| Событие изменения свойстваVerticallyScrollableProperty | Никогда | нет |
| Событие изменения свойстваVerticalViewSizeProperty | Никогда | нет |
| Событие изменения свойстваValueProperty | Зависит | Если элемент управления поддерживает шаблон элемента управления Range Value, то он должен поддерживать данное событие. |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |