SetActiveWindow, fonction (winuser.h)

Article
08/28/2023

Active une fenêtre. La fenêtre doit être jointe à la file d’attente des messages du thread appelant.

Syntaxe

HWND SetActiveWindow(
  [in] HWND hWnd
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre de niveau supérieur à activer.

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour est le handle de la fenêtre précédemment active.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction SetActiveWindow active une fenêtre, mais pas si l’application est en arrière-plan. La fenêtre est mise au premier plan (en haut de Z-Order) si son application se trouve au premier plan lorsque le système active la fenêtre.

Si la fenêtre identifiée par le paramètre hWnd a été créée par le thread appelant, la fenêtre active status du thread appelant est définie sur hWnd. Sinon, la fenêtre active status du thread appelant est définie sur NULL.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-4 (introduit dans Windows 10, version 10.0.14393)