Partager via


SetActiveWindow, fonction (winuser.h)

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)

Voir aussi

Conceptuel

GetActiveWindow

Entrées du clavier

Référence

SetForegroundWindow

WM_ACTIVATE