Изменить тип элемента управления
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления "Изменить".
С помощью элементов управления "Поле ввода" пользователи могут просматривать и изменять простую строку текста без широкой поддержки форматирования.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидную структуру, свойства, шаблоны элементов управления и события для типа элемента управления edit. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления редактирования, где платформа и платформа пользовательского интерфейса интегрируются модель автоматизации пользовательского интерфейса поддержку типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие подразделы.
- Типичная древовидная структура
- Релевантные свойства
- Обязательные шаблоны элементов управления
- Обязательные события
- Замечания
- Связанные темы
Типичная древовидная структура
В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящееся к элементам управления редактирования, и описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Элементы управления, реализующие тип элемента управления Изменить, всегда будут иметь нулевые полосы прокрутки в представлении элемента управления дерева модель автоматизации пользовательского интерфейса, так как это однострочный элемент управления. В некоторых макетах одна строка текста может переноситься. Тип элемента управления "Изменить " предназначен только для небольших объемов текста.
Релевантные свойства
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления редактированием. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе Извлечение свойств из элементов модель автоматизации пользовательского интерфейса.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. примечания. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. примечания. | Элемент управления "Поле ввода должен иметь активную точку, которая предоставляет фокус ввода в часть редактирования элемента управления, когда пользователь щелкает ее мышью. |
| UIA_ControlTypePropertyId | Правка | |
| UIA_IsContentElementPropertyId | TRUE | Элемент управления "Изменить" всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | TRUE | Элемент управления "Изменить" всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_IsPasswordPropertyId | См. примечания. | Для элементов управления редактирования, содержащих пароли, должно быть задано значение TRUE . Если элемент управления "Поле ввода" содержит пароль, то это свойство может использоваться средством чтения с экрана для определения, должны ли считываться нажатия клавиш по мере нажатия их пользователем. |
| UIA_LabeledByPropertyId | См. примечания. | Если с элементом управления связана статическая текстовая метка, это свойство должно предоставлять ссылку на этот элемент управления. Если текстовый элемент управления является подкомпонентом другого элемента управления, для него не будет задано свойство LabeledBy . |
| UIA_LocalizedControlTypePropertyId | См. примечания. | Локализованная строка, соответствующая типу элемента управления Edit . Значение по умолчанию — "edit" для en-US или english (США). |
| UIA_NamePropertyId | См. примечания. | Имя элемента управления "Поле ввода" обычно создается из статического текста метки. Если нет статической текстовой метки, разработчик приложения должен назначить значение свойства Name . Свойство Name никогда не должно содержать текстовое содержимое элемента управления редактирования. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления редактирования. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания |
|---|---|---|
| IRangeValueProvider | Зависит | Все элементы управления редактированием, которые занимают числовой диапазон, должны предоставлять шаблон элемента управления RangeValue . |
| Минимальный | См. примечания. | Это свойство должно быть наименьшим значением, для которого можно задать содержимое элемента управления редактированием. |
| Максимальная | См. примечания. | Это свойство должно быть самым большим значением, для которого можно задать содержимое элемента управления редактированием. |
| SmallChange | См. примечания. | Это свойство должно указывать количество десятичных разрядов, которое может быть в значении. Если элемент управления редактированием принимает только целые числа, значение свойства SmallChange должно быть равно 1. Если элемент управления редактированием принимает диапазон от 1,0 до 2,0, то значение свойства SmallChange должно быть равно 0,1. Если элемент управления редактированием принимает диапазон от 1,00 до 2,00, то значение свойства SmallChange должно быть равно 0,001. |
| LargeChange | NULL | Это свойство не обязательно предоставлять в элементе управления "Поле ввода". |
| Значение | См. примечания. | Это свойство указывает числовое содержимое элемента управления редактированием. Если клиент модель автоматизации пользовательского интерфейса задает более точное значение в диапазонах, указанных в свойствах Минимум и Максимум, свойство Value автоматически округляется до ближайшего допустимого значения. |
| ITextProvider | Обязательно | Все элементы управления редактированием должны поддерживать шаблон элемента управления Текст , так как для клиентов со специальными возможностями всегда должна быть доступна подробная информация. |
| IValueProvider | Зависит | Все элементы управления редактирования, которые принимают строку, должны предоставлять шаблон элемента управления Значение . |
| IsReadOnly | См. примечания. | Это свойство должно быть задано, чтобы указать, может ли элемент управления иметь значение, заданное программными средствами, или же оно может быть изменено пользователем. |
| Значение | См. примечания. | Это свойство содержит текстовое содержимое элемента управления редактированием. Если свойство UIA_IsPasswordPropertyId имеет значение TRUE, запрос свойства Value должен возвращать ошибку. |
Обязательные события
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, для поддержки которых требуются изменения элементов управления. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| Событие модель автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId событие изменения свойства. | |
| UIA_IsEnabledPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие. |
| UIA_IsOffscreenPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие. |
| UIA_NamePropertyId событие изменения свойства. | |
| UIA_RangeValueValuePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления RangeValue , он должен поддерживать это событие. |
| UIA_ScrollHorizontallyScrollablePropertyId событие изменения свойства. | Элемент управления "Редактирование" никогда не поддерживает шаблон элемента управления Scroll . |
| UIA_ScrollHorizontalScrollPercentPropertyId событие изменения свойства. | Элемент управления "Редактирование" никогда не поддерживает шаблон элемента управления Scroll . |
| UIA_ScrollHorizontalViewSizePropertyId событие изменения свойства. | Элемент управления "Редактирование" никогда не поддерживает шаблон элемента управления Scroll . |
| UIA_ScrollVerticallyScrollablePropertyId событие изменения свойства. | Элемент управления "Редактирование" никогда не поддерживает шаблон элемента управления Scroll . |
| UIA_ScrollVerticalScrollPercentPropertyId событие изменения свойства. | Элемент управления "Редактирование" никогда не поддерживает шаблон элемента управления Scroll . |
| UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. | Элемент управления "Редактирование" никогда не поддерживает шаблон элемента управления Scroll . |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Если элемент управления поддерживает шаблон элемента управления Текст , он должен поддерживать это событие. |
| UIA_Text_TextSelectionChangedEventId | Если элемент управления поддерживает шаблон элемента управления Текст , он должен поддерживать это событие. |
| UIA_ValueValuePropertyId событие изменения свойства . | Если элемент управления поддерживает шаблон элемента управления "Значение ", он должен поддерживать это событие. |
Комментарии
Элемент управления "Изменить" можно использовать в качестве текстового поля только для чтения, которое не поддерживает выделение или редактирование текста. Такой элемент управления редактированием ведет себя как объект поля с определенным именем и значением.
Если элемент управления редактированием содержит замещающий текст (например, баннер подсказки), текст следует использовать в качестве свойства HelpText , если пользователь не может изменить текст, а затем повторно использовать в качестве замещающего текста. Например, при открытии новой вкладки в адресной строке Интернет-Обозреватель Windows содержится текст "about:Tabs". Это не HelpText , так как это программный адрес, который может использоваться или изменяться пользователем.
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по