Compartir a través de


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.

IAccessible (Interfaz)