Поделиться через

Изменение типа элемента управления

  • Статья

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

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

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

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

Типичная структура дерева

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

Представление элемента управления Представление содержимого
  • Редактировать
  • Редактировать

 

Элементы управления, реализующие тип элемента управления "Изменение ", всегда будут иметь нулевые полосы прокрутки в представлении элемента управления дерева автоматизации пользовательского интерфейса, так как это однострочный элемент управления. Одна строка текста может быть вложена в некоторые сценарии макета. Тип элемента управления 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 или английского языка (США).
UIA_NamePropertyId См. заметки. Имя элемента управления редактирования обычно создается из статической текстовой метки. Если нет статической текстовой метки, значение свойства для Name должно быть назначено разработчиком приложения. Свойство Name никогда не должно содержать текстовое содержимое элемента управления редактирования.

 

Обязательные шаблоны элементов управления

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

Управление шаблоном или свойством шаблонов Поддержка и значение Примечания
IRangeValueProvider Зависит Все элементы управления редактирования, которые принимают числовой диапазон, должны предоставлять шаблон элемента управления RangeValue.
минимальный См. заметки. Это свойство должно быть наименьшим значением, для которого можно задать содержимое элемента управления редактирования.
максимальное См. заметки. Это свойство должно быть самым большим значением, для которого можно задать содержимое элемента управления редактирования.
SmallChange См. заметки. Это свойство должно указывать количество десятичных разрядов, для которых можно задать значение. Если элемент управления редактирования принимает только целые числа, значение свойства SmallChange должно иметь значение 1. Если элемент управления редактированием принимает диапазон от 1.0 до 2.0, значение свойства SmallChange должно иметь значение 0,1. Если элемент управления редактированием принимает диапазон от 1.00 до 2.00, значение свойства SmallChange должно быть равно 0,001.
LargeChange NULL Это свойство не требуется предоставлять в элементе управления редактированием.
значение См. заметки. Это свойство указывает числовое содержимое элемента управления редактирования. Если более точное значение задается клиентом службы автоматизации пользовательского интерфейса в диапазонах, указанных в свойствах минимального минимального и максимальных свойств, свойствозначение автоматически округляется до ближайшего принятого значения.
ITextProvider Обязательно Все элементы управления редактированием должны поддерживать шаблон управления text, так как подробные сведения всегда должны быть доступны для клиентов вспомогательных технологий.
IValueProvider Зависит Все элементы управления редактирования, которые принимают строку, должны предоставлять шаблон значения.
IsReadOnly См. заметки. Это свойство должно быть задано, чтобы указать, может ли элемент управления иметь значение, заданное программным способом, или его можно изменить пользователем.
значение См. заметки. Это свойство содержит текстовое содержимое элемента управления edit. Если для свойства UIA_IsPasswordPropertyId задано значение TRUE, запрос свойства Value должен вернуть ошибку.

 

Обязательные события

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

Событие автоматизации пользовательского интерфейса Примечания
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 Если элемент управления поддерживает шаблон элемента управления Text, он должен поддерживать это событие.
UIA_Text_TextSelectionChangedEventId Если элемент управления поддерживает шаблон элемента управления Text, он должен поддерживать это событие.
UIA_ValueValuePropertyId событие, измененное свойством. Если элемент управления поддерживает шаблон Value, он должен поддерживать это событие.

 

Замечания

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

Если элемент управления редактирования содержит замещающий текст (например, баннер подсказки), текст следует использовать в качестве свойства HelpText, если текст не может быть изменен пользователем, а затем повторно использоваться в качестве заполнителя. Например, адресная строка Windows Internet Explorer содержит текст "about:Tabs" при открытии новой вкладки. Это не helpText, так как это программный адрес, который можно использовать или редактировать пользователем.

концептуальные

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

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