winuser.h


SetActiveWindow

la función SetActiveWindow activa una ventana.

Sintaxis

HWND SetActiveWindow(
    HWND hWnd  // manipulador de ventana a activar
   );

Parámetros

hWnd: identifica la ventana de mayor nivel a activar.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el manipulador de la ventana que estaba activa previamente.

Observaciones

La función SetActiveWindow activa una ventana, pero no lo hará si la aplicación está en segundo plano. La ventana debe ser llevada a primer plano (primera en el orden Z) si la aplicación está en primer plano cuando realiza la activación.

Si la ventana identificada por el parámetro hWnd fue creada por el hilo que llama, el estado de actividad de ventana del hilo que llama se asigna a hWnd. En otro caso, el estado de actividad de la ventana del hilo se asigna a NULL.

La función SetForegroundWindow, por otra parte, activa una ventana y la fuerza al primer plano. Una aplicación debe llamar a SetForegroundWindow sólo si necesita mostrar errores críticos o información que necesite la atención inmediata del usuario.