Edit Control (справочник по элементу пользовательского интерфейса MSAA)
Заметка
В этом разделе описывается edit Control объекты в целях ссылки на элемент пользовательского интерфейса MSAA. Создание объектов элемента управления редактирования в различных платформах пользовательского интерфейса не описано здесь. См. справочную документацию по API для используемой платформы пользовательского интерфейса.
Изменение элементов управления позволяет пользователю просматривать и изменять текст. Элементы управления редактированием создаются с различными стилями, такими как ES_MULTILINE. Этот стиль создает элемент управления редактирования с несколькими линиями, например клиентская область Блокнота и ES_READONLY, который создает элемент управления редактирования только для чтения.
Microsoft Active Accessibility не делает различия между элементами управления редактированием, созданными с именем класса окна "EDIT" и расширенными элементами управления редактирования, созданными с именем класса окна "RichEdit" или "RichEdit20A".
Недоступные методы
Элементы управления edit поддерживают следующие методы IAccessible:
Свойства IAccessible
Элементы управления "Изменить" поддерживают следующие свойства IAccessible:
| Свойство | Комментарии |
|---|---|
| get_accChild | |
| get_accChildCount | |
| get_accDescription | |
| get_accFocus | |
| get_accKeyboardShortcut | Свойство KeyboardShortcut — это ключ доступа элемента управления редактирования, который является подчеркнутым символом в тексте метки элемента управления редактирования. Например, в стандартном диалоговом окне "Открыть файл", например в WordPad, KeyboardShortcut для элемента управления редактирования с меткой "Имя файла:" имеет значение ALT+n. |
| get_accName | Свойство имени — это текст из статического текстового элемента управления, обозначающего элемент управления редактированием. Например, в стандартном диалоговом окне "Открыть файл", например в WordPad, свойство Name для элемента управления редактирования — "Имя файла:". |
| get_accParent | Свойство Parent — это окно (ROLE_SYSTEM_WINDOW), которое окружает элемент управления и имеет то же имя свойства имени и класса окна, что и элемент управления. |
| get_accRole | Свойство ролиROLE_SYSTEM_TEXT. |
| get_accSelection | |
| get_accState | Свойство State — это сочетание одного или нескольких следующих значений :STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_READONLY | STATE_SYSTEM_PROTECTED | STATE_SYSTEM_NORMAL |
| get_accValue | Свойство значения — это одна строка, содержащая текст в элементе управления редактированием. Однако если элемент управления защищен паролем, свойство Value возвращает E_ACCESSDENIED. Для элементов управления многострочный редактирования строка содержит возврат каретки и новый символ в конце каждой строки. |
Примечания
Microsoft Active Accessibility не поддерживает выделение текста, содержащегося в элементах управления редактирования и расширенных правок, так как текст предоставляется в виде строки в свойстве значения объекта.
Элемент управления расширенными изменениями, предоставляемый Riched20.dll (который используется в текстовых редакторах, таких как WordPad в Windows 98), не отправляет какие-либо элементы WinEvents при изменении положения курсора во время выделения текста. Когда пользователи нажимают клавиши SHIFT и стрелки для выбора текста, объект caret не активирует EVENT_OBJECT_LOCATIONCHANGE WinEvent. Если выбор устанавливается программным образом с помощью расширенных сообщений редактирования, объект caret не отправляет никаких событий, чтобы указать новую позицию.
Все приложения, использующие Riched20.dll, демонстрируют эту проблему. Приложения, использующие более ранние версии элемента управления расширенными изменениями, правильно отправляют события на основе выбора.
Значение состояния для элементов управления изменением пароля всегда включает битовый флаг STATE_SYSTEM_PROTECTED.