Constantes de evento (Winuser.h)
En este tema se describen los eventos generados por el sistema operativo y las aplicaciones de servidor. Las constantes se enumeran en orden alfabético.
Antes de usar estos eventos, las aplicaciones cliente deben usar el Monitor de eventos accesibles para comprobar que los elementos de la interfaz de usuario usan estos eventos.
Para obtener más información sobre los eventos en general, vea ¿Qué son WinEvents?y Eventos de nivel de sistema y de nivel de objeto. Para obtener más información sobre los eventos enviados por el sistema, vea Apéndice A: Referencia de elementos de interfaz de usuario compatibles.
| Constante o valor | Descripción |
|---|---|
|
Intervalo de valores constantes de WinEvent especificados por accessibility Interoperability Alliance (AIA) para su uso en toda la industria. Para obtener más información, vea Asignación de identificadores winEvent. |
|
Los valores de evento más bajos y máximos posibles. |
|
La propiedad KeyboardShortcut de un objeto ha cambiado. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
|
Se envía cuando se oculta una ventana. Todavía existe una ventana oculta, pero es invisible para el usuario. |
|
El desplazamiento de un objeto de ventana ha finalizado. A diferencia de EVENT_SYSTEM_SCROLLEND, este evento está asociado a la ventana de desplazamiento. Tanto si el desplazamiento es horizontal como vertical, este evento debe enviarse cada vez que se complete la acción de desplazamiento. El parámetro hwnd de la función de devolución de llamada WinEventProc describe la ventana de desplazamiento; el parámetro idObject es OBJID_CLIENT y el parámetro idChild es CHILDID_SELF. |
|
Se ha creado un objeto. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación, control de encabezado, control de vista de lista, control de tabulación, control de barra de herramientas, control de vista de árbol y objeto de ventana . Las aplicaciones de servidor envían este evento para sus objetos accesibles. Antes de enviar el evento para el objeto primario, los servidores deben enviarlos para todos los objetos secundarios de un objeto. Los servidores deben asegurarse de que todos los objetos secundarios estén completamente creados y listos para aceptar llamadas IAccessible desde clientes antes de que el objeto primario envíe este evento. Dado que un objeto primario se crea después de sus objetos secundarios, los clientes deben asegurarse de que se ha creado el elemento primario de un objeto antes de llamar a IAccessible::get_accParent, especialmente si se usan funciones de enlace en contexto. |
|
La propiedad DefaultAction de un objeto ha cambiado. El sistema envía este evento para cuadros de diálogo. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
|
La propiedad Description de un objeto ha cambiado. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
|
Se ha destrozado un objeto. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación, control de encabezado, control de vista de lista, control de tabulación, control de barra de herramientas, control de vista de árbol y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Los clientes asumen que todos los elementos secundarios de un objeto se destruyen cuando el objeto primario envía este evento. Después de recibir este evento, los clientes no llaman a los métodos ni propiedades IAccessible de un objeto. Sin embargo, el puntero de interfaz debe permanecer válido siempre que haya un recuento de referencias en él (debido a las reglas COM), pero es posible que el elemento de la interfaz de usuario ya no esté presente. Otras llamadas en el puntero de interfaz pueden devolver errores de error; para evitar esto, los servidores crean objetos proxy y supervisan sus intervalos de vida. |
|
El usuario comenzó a arrastrar un elemento. Los parámetros hwnd, idObject e idChild de la función de devolución de llamada WinEventProc identifican el objeto que se está arrastrando. |
|
El usuario ha finalizado una operación de arrastrar antes de colocar el elemento arrastrado en un destino de colocación. Los parámetros hwnd, idObject e idChild de la función de devolución de llamada WinEventProc identifican el objeto que se está arrastrando. |
|
El usuario quitó un elemento en un destino de colocación. Los parámetros hwnd, idObject e idChild de la función de devolución de llamada WinEventProc identifican el objeto que se está arrastrando. |
|
El usuario arrastró un elemento al límite de un destino de colocación. Los parámetros hwnd, idObject e idChild de la función de devolución de llamada WinEventProc identifican el destino de colocación. |
|
El usuario arrastró un elemento fuera del límite de un destino de colocación. Los parámetros hwnd, idObject e idChild de la función de devolución de llamada WinEventProc identifican el destino de colocación. |
|
El usuario quitó un elemento en un destino de colocación. Los parámetros hwnd, idObject e idChild de la función de devolución de llamada WinEventProc identifican el destino de colocación. |
|
Valor de evento de objeto más alto. |
|
Un objeto ha recibido el foco de teclado. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: control de vista de lista, barra de menús, menú emergente, ventana de conmutador, control de tabulación, control de vista de árbol y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. El parámetro hwnd de la función de devolución de llamada WinEventProc identifica la ventana que recibe el foco del teclado. |
|
La propiedad Help de un objeto ha cambiado. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
|
Un objeto está oculto. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación y cursor. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Cuando se genera este evento para un objeto primario, todos los objetos secundarios ya están ocultos. Las aplicaciones de servidor no envían este evento para los objetos secundarios. Los objetos ocultos incluyen la marca STATE_SYSTEM_INVISIBLE ; los objetos mostrados no incluyen esta marca. El evento EVENT_OBJECT_HIDE también indica que se ha establecido la marca STATE_SYSTEM_INVISIBLE . Por lo tanto, los servidores no envían el evento EVENT_OBJECT_STATECHANGE en este caso. |
|
Una ventana que hospeda otros objetos accesibles ha cambiado los objetos hospedados. Es posible que un cliente necesite consultar la ventana host para detectar los nuevos objetos hospedados, especialmente si el cliente ha estado supervisando eventos desde la ventana. Un objeto hospedado es un objeto de un marco de accesibilidad (MSAA o automatización de la interfaz de usuario) diferente del del host. Los cambios en los objetos hospedados que proceden del mismo marco que el host deben entregarse con los eventos de cambio estructural, como EVENT_OBJECT_CREATE para MSAA. Para obtener más información, consulta comentarios en winuser.h. |
|
Se ha ocultado una ventana de IME. |
|
Una ventana IME se ha vuelto visible. |
|
El tamaño o la posición de una ventana IME ha cambiado. |
|
Se ha invocado un objeto; por ejemplo, el usuario ha realizado clic en un botón. Este evento es compatible con controles comunes y lo usa automatización de la interfaz de usuario. Para este evento, los parámetros hwnd, ID e idChild de la función de devolución de llamada WinEventProc identifican el elemento que se invoca. |
|
Un objeto que forma parte de una región activa ha cambiado. Una región activa es un área de una aplicación que cambia con frecuencia o de forma asincrónica. |
|
Se ha modificado la ubicación, la forma o el tamaño de un objeto. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación y objetos de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Este evento se genera en respuesta a un cambio en el objeto de nivel superior dentro de la jerarquía de objetos; no se genera para ningún elemento secundario que el objeto pueda tener. Por ejemplo, si el usuario cambia el tamaño de una ventana, el sistema envía esta notificación para la ventana, pero no para la barra de menús, la barra de título, la barra de desplazamiento u otros objetos que también han cambiado. El sistema no envía este evento para todas las ventanas secundarias no flotantes cuando se mueve el primario. Sin embargo, si una aplicación cambia explícitamente el tamaño de las ventanas secundarias como resultado de cambiar el tamaño de la ventana primaria, el sistema envía varios eventos para los elementos secundarios cuyo tamaño ha cambiado. Si la propiedad State de un objeto se establece en STATE_SYSTEM_FLOATING, el servidor envía EVENT_OBJECT_LOCATIONCHANGE cada vez que cambia la ubicación del objeto. Si un objeto no tiene este estado, los servidores solo desencadenan este evento cuando el objeto se mueve en relación con su elemento primario. Para esta notificación de eventos, el parámetro idChild de la función de devolución de llamada WinEventProc identifica el objeto secundario que ha cambiado. |
|
La propiedad Name de un objeto ha cambiado. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: casilla, cursor, control de vista de lista, botón de pulsación, botón de radio, control de barra de estado, control de vista de árbol y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
|
Un objeto tiene un nuevo objeto primario. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
|
Un objeto contenedor ha agregado, quitado o reordenado sus secundarios. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: control de encabezado, control de vista de lista, control de barra de herramientas y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles, según corresponda. Por ejemplo, un objeto list-view genera este evento cuando cambia el número de elementos secundarios o el orden de los elementos. Este evento también lo envía una ventana primaria cuando cambia el orden Z de las ventanas secundarias. |
|
La selección dentro de un objeto contenedor ha cambiado. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: control de vista de lista, control de tabulación, control de vista de árbol y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Este evento señala una única selección: se selecciona un elemento secundario en un contenedor que anteriormente no contenía ningún elemento secundario seleccionado o la selección ha cambiado de un elemento secundario a otro. Los parámetros hwnd e idObject de la función de devolución de llamada WinEventProc describen el contenedor; el parámetro idChild identifica el objeto seleccionado. Si el elemento secundario seleccionado es una ventana que también contiene objetos, el parámetro idChild se OBJID_WINDOW. |
|
Se ha agregado un elemento secundario dentro de un objeto contenedor a una selección existente. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: cuadro de lista, control de vista de lista y control de vista de árbol. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Los parámetros hwnd e idObject de la función de devolución de llamada WinEventProc describen el contenedor. El parámetro idChild es el elemento secundario que se agrega a la selección. |
|
Se ha quitado un elemento de un objeto contenedor de la selección. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: cuadro de lista, control de vista de lista y control de vista de árbol. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Este evento indica que se quita un elemento secundario de una selección existente. Los parámetros hwnd e idObject de la función de devolución de llamada WinEventProc describen el contenedor; El parámetro idChild identifica el elemento secundario que se ha quitado de la selección. |
|
Se han producido numerosos cambios de selección en un objeto contenedor. El sistema envía este evento para cuadros de lista; las aplicaciones de servidor la envían para sus objetos accesibles. Este evento se envía cuando los elementos seleccionados dentro de un control han cambiado sustancialmente. El evento informa al cliente de que se han producido muchos cambios de selección y se envía en lugar de varios eventos de EVENT_OBJECT_SELECTIONADD o EVENT_OBJECT_SELECTIONREMOVE . El cliente consulta los elementos seleccionados llamando al método IAccessible::get_accSelection del objeto contenedor y enumerando los elementos seleccionados. Para esta notificación de eventos, los parámetros hwnd e idObject de la función de devolución de llamada WinEventProc describen el contenedor en el que se produjeron los cambios. |
|
Se muestra un objeto oculto. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación, cursor y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Los clientes asumen que cuando un objeto primario envía este evento, ya se muestran todos los objetos secundarios. Por lo tanto, las aplicaciones de servidor no envían este evento para los objetos secundarios. Los objetos ocultos incluyen la marca STATE_SYSTEM_INVISIBLE ; los objetos mostrados no incluyen esta marca. El evento EVENT_OBJECT_SHOW también indica que se borra la marca STATE_SYSTEM_INVISIBLE . Por lo tanto, los servidores no envían el evento EVENT_OBJECT_STATECHANGE en este caso. |
|
El estado de un objeto ha cambiado. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: casilla, cuadro combinado, control de encabezado, botón de pulsación, botón de radio, barra de herramientas, control de barra de herramientas, control de vista de árbol, control de arriba abajo y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Por ejemplo, un cambio de estado se produce cuando se hace clic o se suelta un objeto de botón, o cuando un objeto está habilitado o deshabilitado. Para esta notificación de eventos, el parámetro idChild de la función de devolución de llamada WinEventProc identifica el objeto secundario cuyo estado ha cambiado. |
|
El destino de conversión dentro de una composición IME ha cambiado. El destino de conversión es el subconjunto de la composición IME que se selecciona activamente como destino para las conversiones iniciadas por el usuario. |
|
La selección de texto de un objeto ha cambiado. Este evento es compatible con los controles comunes y lo usa la automatización de la interfaz de usuario. Los parámetros hwnd, ID e idChild de la función de devolución de llamada WinEventProc describen el elemento contenido en la selección de texto actualizada. |
|
Se envía cuando una ventana no está oculta. Todavía existe una ventana oculta, pero es invisible para el usuario. |
|
La propiedad Value de un objeto ha cambiado. El sistema envía este evento para los elementos de la interfaz de usuario que incluyen la barra de desplazamiento y los siguientes controles: edit, header, hot key, progress bar, slider y up-down. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
|
Intervalo de valores constantes de evento reservados para los OEM. Para obtener más información, vea Asignación de identificadores de WinEvent. |
|
Se ha generado una alerta. Las aplicaciones de servidor no deben enviar este evento. |
|
Se muestra un rectángulo de vista previa. |
|
Una ventana ha perdido la captura del mouse. El sistema envía este evento, nunca por los servidores. |
|
Una ventana ha recibido la captura del mouse. El sistema envía este evento, nunca por los servidores. |
|
Una ventana ha salido del modo de ayuda contextual. El sistema no envía este evento de forma coherente. |
|
Una ventana ha entrado en el modo de ayuda contextual. El sistema no envía este evento de forma coherente. |
|
Se ha cambiado el escritorio activo. |
|
Se ha cerrado un cuadro de diálogo. El sistema envía este evento para los cuadros de diálogo estándar; los servidores lo envían para cuadros de diálogo personalizados. El sistema no envía este evento de forma coherente. |
|
Se ha mostrado un cuadro de diálogo. El sistema envía este evento para los cuadros de diálogo estándar, que se crean mediante plantillas de recursos o funciones del cuadro de diálogo Win32. Los servidores envían este evento para cuadros de diálogo personalizados, que son ventanas que funcionan como cuadros de diálogo, pero no se crean de la manera estándar. El sistema no envía este evento de forma coherente. |
|
Una aplicación va a salir del modo de arrastrar y colocar. Las aplicaciones que admiten operaciones de arrastrar y colocar deben enviar este evento; el sistema no envía este evento. |
|
Una aplicación va a entrar en el modo de arrastrar y colocar. Las aplicaciones que admiten operaciones de arrastrar y colocar deben enviar este evento porque el sistema no lo envía. |
|
Valor de evento del sistema más alto. |
|
La ventana de primer plano ha cambiado. El sistema envía este evento incluso si la ventana de primer plano ha cambiado a otra ventana del mismo subproceso. Las aplicaciones de servidor nunca envían este evento. Para este evento, el parámetro hwnd de la función de devolución de llamada de WinEventProc es el identificador de la ventana que está en primer plano, el parámetro idObject se OBJID_WINDOW y el parámetro idChild es CHILDID_SELF. |
|
Se ha cerrado un menú emergente. El sistema envía este evento para los menús estándar; los servidores lo envían para menús personalizados. Cuando se cierra un menú emergente, el cliente recibe este mensaje y, a continuación, el evento EVENT_SYSTEM_MENUEND . El sistema no envía este evento de forma coherente. |
|
Se ha mostrado un menú emergente. El sistema envía este evento para los menús estándar, que se identifican mediante HMENU, y se crean mediante recursos de plantilla de menú o funciones de menú Win32. Los servidores envían este evento para los menús personalizados, que son elementos de la interfaz de usuario que funcionan como menús, pero no se crean de la manera estándar. El sistema no envía este evento de forma coherente. |
|
Se ha cerrado un menú de la barra de menús. El sistema envía este evento para los menús estándar; los servidores lo envían para menús personalizados. Para este evento, los parámetros hwnd, idObject e idChild de la función WinEventProc hacen referencia al control que contiene la barra de menús o el control que activa el menú contextual. El parámetro hwnd es el identificador de la ventana que está relacionada con el evento. El parámetro idObject se OBJID_MENU o OBJID_SYSMENU para un menú o OBJID_WINDOW para un menú emergente. El parámetro idChild es CHILDID_SELF. |
|
Se ha seleccionado un elemento de menú en la barra de menús. El sistema envía este evento para los menús estándar, que se identifican mediante HMENU, creados mediante recursos de plantilla de menú o elementos de LA API de menú Win32. Los servidores envían este evento para los menús personalizados, que son elementos de la interfaz de usuario que funcionan como menús, pero no se crean de la manera estándar. Para este evento, los parámetros hwnd, idObject e idChild de la función WinEventProc hacen referencia al control que contiene la barra de menús o el control que activa el menú contextual. El parámetro hwnd es el identificador de la ventana relacionada con el evento. El parámetro idObject se OBJID_MENU o OBJID_SYSMENU para un menú o OBJID_WINDOW para un menú emergente. El parámetro idChild es CHILDID_SELF. El sistema desencadena más de un evento de EVENT_SYSTEM_MENUSTART que no siempre se corresponde con el evento EVENT_SYSTEM_MENUEND . |
|
Un objeto de ventana está a punto de restaurarse. El sistema envía este evento, nunca por los servidores. |
|
Un objeto de ventana está a punto de minimizarse. El sistema envía este evento, nunca por los servidores. |
|
El movimiento o el cambio de tamaño de una ventana ha finalizado. El sistema envía este evento, nunca por los servidores. |
|
Se ha movido o se ha cambiado el tamaño de una ventana. El sistema envía este evento, nunca por los servidores. |
|
Ha finalizado el desplazamiento en una barra de desplazamiento. El sistema envía este evento para los controles de barra de desplazamiento estándar y para las barras de desplazamiento que están asociadas a una ventana. Los servidores envían este evento para barras de desplazamiento personalizadas, que son elementos de la interfaz de usuario que funcionan como barras de desplazamiento, pero no se crean de la manera estándar. El parámetro idObject que se envía a la función de devolución de llamada WinEventProc es OBJID_HSCROLL para barras de desplazamiento horizontales y OBJID_VSCROLL para barras de desplazamiento verticales. |
|
Se ha iniciado el desplazamiento en una barra de desplazamiento. El sistema envía este evento para los controles de barra de desplazamiento estándar y para las barras de desplazamiento conectadas a una ventana. Los servidores envían este evento para barras de desplazamiento personalizadas, que son elementos de la interfaz de usuario que funcionan como barras de desplazamiento, pero no se crean de la manera estándar. El parámetro idObject que se envía a la función de devolución de llamada WinEventProc es OBJID_HSCROLL para barras de desplazamiento horizontales y OBJID_VSCROLL para barras de desplazamiento verticales. |
|
Se ha reproducido un sonido. El sistema envía este evento cuando se reproduce un sonido del sistema, como uno para un menú, incluso si no hay sonido audible (por ejemplo, debido a la falta de un archivo de sonido o una tarjeta de sonido). Los servidores envían este evento cada vez que un elemento de interfaz de usuario personalizado genera un sonido. Para este evento, la función de devolución de llamada WinEventProc recibe el valor OBJID_SOUND como parámetro idObject . |
|
El usuario ha publicado ALT+TAB. El sistema envía este evento, nunca por los servidores. El parámetro hwnd de la función de devolución de llamada WinEventProc identifica la ventana a la que ha cambiado el usuario. Si solo se ejecuta una aplicación cuando el usuario presiona ALT+TAB, el sistema envía este evento sin un evento de EVENT_SYSTEM_SWITCHSTART correspondiente. |
|
El usuario ha presionado ALT+TAB, que activa la ventana del conmutador. El sistema envía este evento, nunca por los servidores. El parámetro hwnd de la función de devolución de llamada WinEventProc identifica la ventana a la que cambia el usuario. Si solo se ejecuta una aplicación cuando el usuario presiona ALT+TAB, el sistema envía un evento de EVENT_SYSTEM_SWITCHEND sin un evento de EVENT_SYSTEM_SWITCHSTART correspondiente. |
|
Intervalo de valores constantes de evento reservados para identificadores de eventos de Automatización de la interfaz de usuario. Para obtener más información, vea Asignación de identificadores de WinEvent. |
|
Intervalo de valores constantes de evento reservados para identificadores de eventos modificados por propiedades de automatización de la interfaz de usuario. Para obtener más información, vea Asignación de identificadores de WinEvent. |
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de