SetWindowPlacement, fonction (winuser.h)

  • Article

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

Syntaxe

BOOL SetWindowPlacement(
  [in] HWND                  hWnd,
  [in] const WINDOWPLACEMENT *lpwndpl
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre.

[in] lpwndpl

Type : const WINDOWPLACEMENT*

Pointeur vers une structure WINDOWPLACEMENT qui spécifie le nouvel état d’affichage et les nouvelles positions de fenêtre.

Avant d’appeler SetWindowPlacement, définissez le membre de longueur de la structure WINDOWPLACEMENT sur sizeof(WINDOWPLACEMENT). SetWindowPlacement échoue si le membre de longueur 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

Si les informations spécifiées dans WINDOWPLACEMENT entraînent une fenêtre complètement hors de l’écran, le système ajuste automatiquement les coordonnées afin que la fenêtre soit visible, en tenant compte des modifications apportées à la résolution de l’écran et de la configuration de plusieurs moniteurs.

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.

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-3 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

Conceptuel

GetWindowPlacement

Référence

WINDOWPLACEMENT

Windows