GetWindowPlacement, fonction (winuser.h)

  • Article

Récupère l’état d’affichage et les positions restaurées, réduites et agrandies de la fenêtre spécifiée.

Syntaxe

BOOL GetWindowPlacement(
  [in]      HWND            hWnd,
  [in, out] WINDOWPLACEMENT *lpwndpl
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre.

[in, out] lpwndpl

Type : WINDOWPLACEMENT*

Pointeur vers la structure WINDOWPLACEMENT qui reçoit les informations d’état et de position d’affichage. Avant d’appeler GetWindowPlacement, définissez le membre de longueur sur sizeof(WINDOWPLACEMENT). GetWindowPlacement échoue si lpwndpl-length> n’est pas défini correctement.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

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

Remarques

Le membre d’indicateurs de WINDOWPLACEMENT récupéré par cette fonction est toujours égal à zéro. Si la fenêtre identifiée par le paramètre hWnd est agrandie, le membre showCmd est SW_SHOWMAXIMIZED. Si la fenêtre est réduite, showCmd est SW_SHOWMINIMIZED. Sinon, c’est SW_SHOWNORMAL.

Le membre de longueur de WINDOWPLACEMENT doit être défini sur sizeof(WINDOWPLACEMENT). Si ce membre n’est pas défini correctement, la fonction retourne FALSE. Pour obtenir des remarques supplémentaires sur l’utilisation appropriée des coordonnées de placement de fenêtre, consultez WINDOWPLACEMENT.

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

SetWindowPlacement

WINDOWPLACEMENT

Windows