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

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

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

Элементы управления "Поле ввода" позволяют пользователю просматривать и изменять простую строку текста без широкой поддержки форматирования.

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

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

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

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

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

Представление элемента управления	Представление содержимого
Edit	Edit

Элементы управления, которые реализуют тип элемента управления "Поле ввода", будут всегда иметь нулевые полосы прокрутки в представлении дерева UI Automation, так как это однострочный элемент управления. Строка текста может быть перенесена в некоторых скриптах макета. Элемент управления типа Edit лучше всего подходит для небольших объемов редактируемого или выбираемого текста.

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

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

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

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

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

Шаблон элемента управления/свойство шаблона элемента управления	Поддержка/значение	Примечания
ITextProvider	Зависит от конкретного случая	Элементы управления "Поле ввода" должны поддерживать шаблон элемента управления Text, поскольку клиентам всегда должна быть доступна подробная текстовая информация.
IValueProvider	Зависит от конкретного случая	Все элементы управления поля ввода, которые принимают строку, должны предоставлять шаблон "Значение".
IsReadOnly	См. примечания.	Это свойство должно быть задано, чтобы указать, может ли элемент управления иметь значение, присвоенное программно, или же он изменяется пользователем.
Value	См. примечания.	Это свойство будет возвращать текстовое содержимое элемента управления поля ввода. Если для свойства IsPasswordProperty установлено значение true, это свойство должно создавать исключение InvalidOpertaionException при запросе его значения.
IRangeValueProvider	Зависит от конкретного случая	Все элементы управления поля ввода, которые принимают числовой диапазон, должны предоставлять шаблон элемента управления "Значение диапазона".
Minimum	См. примечания.	Это свойство должно быть наименьшим значением, которое можно задать в содержимом элемента управления поля ввода.
Maximum	См. примечания.	Это свойство должно быть наибольшим значением, которое можно задать в содержимом элемента управления поля ввода.
SmallChange	См. примечания.	Это свойство должно указывать количество знаков после запятой, которое можно задать для значения. Если элемент управления "Поле ввода" принимает только целые значения, свойство SmallChangeProperty должно иметь значение 1. Если элемент управления "Поле ввода" принимает значения из диапазона от 1,0 до 2,0, свойство SmallChangeProperty должно иметь значение 0,1. Если элемент управления "Поле ввода" принимает значения из диапазона от 1,00 до 2,00, свойство SmallChangeProperty должно иметь значение 0,001.
LargeChange	Null	Это свойство не требуется представлять в элементе управления поля ввода.
Value	См. примечания.	Это свойство будет указывать числовое содержимое элемента управления поля ввода. Если клиентом UI Automation устанавливается более точное значение в диапазоне, заданном свойствами Minimum и Maximum, свойство "Value" будет автоматически округляться до ближайшего принятого значения.

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

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

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

См. также

Ссылки

Edit

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

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

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