Función SetActiveWindow (winuser.h)

Artículo
08/28/2023

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)