GetWindowPlacement, fonction (winuser.h)
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