Editar control (referencia de elementos de interfaz de usuario de MSAA)
Nota
En este tema se describen los objetos Edit Control con fines de referencia de elementos de la interfaz de usuario de MSAA. Aquí no se describe cómo crear objetos Edit Control en varios marcos de interfaz de usuario. Consulte la documentación de referencia de API para el marco de interfaz de usuario que usa.
Los controles de edición permiten a un usuario ver y editar texto. Los controles de edición se crean con muchos estilos diferentes, como ES_MULTILINE. Este estilo crea un control de edición multilínea, como el área cliente del Bloc de notas y ES_READONLY, que crea un control de edición de solo lectura.
La accesibilidad activa de Microsoft no distingue entre los controles de edición creados con el nombre de clase de ventana "EDIT" y los controles de edición enriquecidos creados con el nombre de clase de ventana "RichEdit" o "RichEdit20A".
Métodos IAccessible
Los controles de edición admiten los siguientes métodos IAccessible :
Propiedades IAccessible
Los controles de edición admiten las siguientes propiedades IAccessible :
| Propiedad | Comentarios |
|---|---|
| get_accChild | |
| get_accChildCount | |
| get_accDescription | |
| get_accFocus | |
| get_accKeyboardShortcut | La propiedad KeyboardShortcut es la tecla de acceso del control de edición, que es un carácter subrayado en el texto de la etiqueta del control de edición. Por ejemplo, en un cuadro de diálogo Abrir archivo estándar, como en WordPad, keyboardShortcut para el control de edición con la etiqueta "Filename:" es "Alt+n". |
| get_accName | La propiedad Name es el texto de un control de texto estático que etiqueta el control de edición. Por ejemplo, en un cuadro de diálogo Abrir archivo estándar, como en WordPad, la propiedad Name del control de edición es "Nombre de archivo:". |
| get_accParent | La propiedad Parent es una ventana ( ROLE_SYSTEM_WINDOW ) que rodea el control y tiene la misma propiedad Name y el mismo nombre de clase de ventana que el control. |
| get_accRole | La propiedad Role es ROLE_SYSTEM_TEXT. |
| get_accSelection | |
| get_accState | La propiedad State es una combinación de uno o varios de los siguientes valores: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_FOCUSED | | STATE_SYSTEM_READONLY | STATE_SYSTEM_PROTECTED | STATE_SYSTEM_NORMAL |
| get_accValue | La propiedad Value es una sola cadena que contiene el texto del control de edición. Sin embargo, si el control está protegido con contraseña, la propiedad Value devuelve E_ACCESSDENIED. Para los controles de edición de varias líneas, la cadena contiene un retorno de carro y un carácter de nueva línea al final de cada línea. |
Notas
La accesibilidad activa de Microsoft no admite la selección del texto contenido en los controles de edición y edición enriquecida porque el texto se expone como una cadena en la propiedad Value del objeto.
El control de edición enriquecido proporcionado por Riched20.dll (que se usa en editores de texto como WordPad en Windows 98) no envía ningún WinEvents cuando se cambia la posición del símbolo de intercalación durante la selección de texto. Cuando los usuarios presionan MAYÚS y las teclas de dirección para seleccionar texto, el objeto de intercalación no desencadena el EVENT_OBJECT_LOCATIONCHANGE WinEvent. Cuando la selección se establece mediante programación a través de mensajes de edición enriquecidos, el objeto de intercalación no envía ningún evento para indicar su nueva posición.
Todas las aplicaciones que usan Riched20.dll presentan este problema. Las aplicaciones que usan versiones anteriores del control de edición enriquecido envían correctamente eventos en función de la selección.
El valor de Estado de los controles de edición de contraseñas siempre incluye la marca de bits STATE_SYSTEM_PROTECTED.