GetWindow, fonction (winuser.h)
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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
Référence