GetWindow, fonction (winuser.h)

  • Article

Récupère un handle dans une fenêtre qui a la relation spécifiée (ordre Z ou propriétaire) à la fenêtre spécifiée.

Syntaxe

HWND GetWindow(
  [in] HWND hWnd,
  [in] UINT uCmd
);

Paramètres

[in] hWnd

Type : HWND

Handle d'une fenêtre. Le handle de fenêtre récupéré est relatif à cette fenêtre, en fonction de la valeur du paramètre uCmd .

[in] uCmd

Type : UINT

Relation entre la fenêtre spécifiée et la fenêtre dont le handle doit être récupéré. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
GW_CHILD
5
 Le handle récupéré identifie la fenêtre enfant en haut de l’ordre Z, si la fenêtre spécifiée est une fenêtre parente ; sinon, le handle récupéré est NULL. La fonction examine uniquement les fenêtres enfants de la fenêtre spécifiée. Il n’examine pas les fenêtres descendantes.
GW_ENABLEDPOPUP
6
 Le handle récupéré identifie la fenêtre contextuelle activée appartenant à la fenêtre spécifiée (la recherche utilise la première fenêtre de ce type trouvée à l’aide de GW_HWNDNEXT) ; sinon, si aucune fenêtre contextuelle n’est activée, le handle récupéré est celui de la fenêtre spécifiée.
GW_HWNDFIRST
0
 Le handle récupéré identifie la fenêtre du même type que celui qui est le plus élevé dans l’ordre Z.

Si la fenêtre spécifiée est une fenêtre la plus haute, le handle identifie une fenêtre supérieure. Si la fenêtre spécifiée est une fenêtre de niveau supérieur, le handle identifie une fenêtre de niveau supérieur. Si la fenêtre spécifiée est une fenêtre enfant, le handle identifie une fenêtre frère.
GW_HWNDLAST
1
 Le handle récupéré identifie la fenêtre du même type qui est le plus bas dans l’ordre Z.

Si la fenêtre spécifiée est une fenêtre la plus haute, le handle identifie une fenêtre supérieure. Si la fenêtre spécifiée est une fenêtre de niveau supérieur, le handle identifie une fenêtre de niveau supérieur. Si la fenêtre spécifiée est une fenêtre enfant, le handle identifie une fenêtre frère.
GW_HWNDNEXT
2
 Le handle récupéré identifie la fenêtre sous la fenêtre spécifiée dans l’ordre Z.

Si la fenêtre spécifiée est une fenêtre la plus haute, le handle identifie une fenêtre supérieure. Si la fenêtre spécifiée est une fenêtre de niveau supérieur, le handle identifie une fenêtre de niveau supérieur. Si la fenêtre spécifiée est une fenêtre enfant, le handle identifie une fenêtre frère.
GW_HWNDPREV
3
 Le handle récupéré identifie la fenêtre au-dessus de la fenêtre spécifiée dans l’ordre Z.

Si la fenêtre spécifiée est une fenêtre la plus haute, le handle identifie une fenêtre supérieure. Si la fenêtre spécifiée est une fenêtre de niveau supérieur, le handle identifie une fenêtre de niveau supérieur. Si la fenêtre spécifiée est une fenêtre enfant, le handle identifie une fenêtre frère.
GW_OWNER
4
 Le handle récupéré identifie la fenêtre propriétaire de la fenêtre spécifiée, le cas échéant. Pour plus d’informations, consultez Windows possédé.

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour est un handle de fenêtre. Si aucune fenêtre n’existe avec la relation spécifiée avec la fenêtre spécifiée, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction EnumChildWindows est plus fiable que l’appel de GetWindow dans une boucle. Une application qui appelle GetWindow pour effectuer cette tâche risque d’être interceptée dans une boucle infinie ou de référencer un handle à une fenêtre qui a été détruite.

Configuration requise

Condition requise Valeur
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-0 (introduit dans Windows 8)

Voir aussi

Conceptuel

EnumChildWindows

Référence

Windows