Compartir a través de


Función SetActiveWindow (winuser.h)

Activa una ventana. La ventana debe asociarse a la cola de mensajes del subproceso que llama.

Sintaxis

HWND SetActiveWindow(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana de nivel superior que se va a activar.

Valor devuelto

Tipo: HWND

Si la función se realiza correctamente, el valor devuelto es el identificador de la ventana que estaba activa anteriormente.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función SetActiveWindow activa una ventana, pero no si la aplicación está en segundo plano. La ventana se incorporará en primer plano (parte superior de Z-Order) si su aplicación está en primer plano cuando el sistema activa la ventana.

Si la ventana identificada por el parámetro hWnd se creó mediante el subproceso que realiza la llamada, el estado de la ventana activa del subproceso que realiza la llamada se establece en hWnd. De lo contrario, el estado de la ventana activa del subproceso que realiza la llamada se establece en NULL.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-window-l1-1-4 (introducido en Windows 10, versión 10.0.14393)

Consulte también

Conceptual

GetActiveWindow

Entrada de teclado

Referencia

SetForegroundWindow

WM_ACTIVATE