winuser.h

Mensaje WM_MOUSEACTIVATE

Definición

WM_MOUSEACTIVATE  
hwndTopLevel = (HWND) wParam;     // manipulador de padre de mayor nivel
nHittest = (INT) LOWORD(lParam);  // valor hit-test
uMsg =    (UINT) HIWORD(lParam);  // mensaje del ratón

El mensaje WM_MOUSEACTIVATE se envía cuando el cursor está sobre una ventana inactiva y el usuario presiona uno de los botones de ratón. La ventana padre recibe este mensaje sólo si la ventana hija los pasa a la función DefWindowProc.

Descripción

hwndTopLevel: valor de wParam. Identifica la ventana padre de mayor nivel de la ventana que será activada.

nHittest: valor de la palabra de menor peso de lParam. Especifica el valor hit-test revuelto por la función DefWindowProc como un resultado de procesar el mensaje WM_NCHITTEST. Para ver una lista de los valores de hit-test, ver WM_NCHITTEST.

uMsg: valor de la palabra de mayor peso de lParam. Especifica el identificador del mensaje de ratón generado cuando el usuario presionó en botón del ratón. El mensaje de ratón puede ser descartado o bien enviado (post) a la ventana, dependiendo del valor de retorno.

Valor de retorno

El valor de retorno especifica si la ventana debe ser activada y si el identificador de mensaje de ratón debe ser descartado. Debe ser uno de los siguientes valores:

Valor Significado
MA_ACTIVATE Activa la ventana, y no descarta el mensaje de ratón.
MA_ACTIVATEANDEAT Activa la ventana, y descarta el mensaje de ratón.
MA_NOACTIVATE No activa la ventana, y no descarta el mensaje de ratón.
MA_NOACTIVATEANDEAT No activa la ventana, pero descarta el mensaje de ratón.

Acción por defecto

La función DefWindowProc pasa el mensaje a la ventana padre de la ventana hija antes de que se produzca cualquier proceso. La ventana padre determina si activa la ventana hija. Si lo hace, la ventana padre debe retornar TRUE para evitar que el sistema procese el mensaje.