MoveWindow, fonction (winuser.h)

Article
03/13/2024

Modifie la position et les dimensions de la fenêtre spécifiée. Pour une fenêtre de niveau supérieur, la position et les dimensions sont relatives à l’angle supérieur gauche de l’écran. Pour une fenêtre enfant, elles sont relatives au coin supérieur gauche de la zone cliente de la fenêtre parente.

Syntaxe

BOOL MoveWindow(
  [in] HWND hWnd,
  [in] int  X,
  [in] int  Y,
  [in] int  nWidth,
  [in] int  nHeight,
  [in] BOOL bRepaint
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre.

[in] X

Type : int

Nouvelle position du côté gauche de la fenêtre.

[in] Y

Type : int

Nouvelle position du haut de la fenêtre.

[in] nWidth

Type : int

Nouvelle largeur de la fenêtre.

[in] nHeight

Type : int

Nouvelle hauteur de la fenêtre.

[in] bRepaint

Type : BOOL

Indique si la fenêtre doit être repeinte. Si ce paramètre a la valeur TRUE, la fenêtre reçoit un message. Si le paramètre a la valeur FALSE, aucun repeint de quelque type que ce soit ne se produit. Cela s’applique à la zone cliente, à la zone non cliente (y compris la barre de titre et les barres de défilement) et à toute partie de la fenêtre parente découverte suite au déplacement d’une fenêtre enfant.

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 le paramètre bRepaint a la valeur TRUE, le système envoie le message WM_PAINT à la procédure de fenêtre immédiatement après le déplacement de la fenêtre (autrement dit, la fonction MoveWindow appelle la fonction UpdateWindow ). Si bRepaint a la valeur FALSE, l’application doit invalider ou redessiner explicitement toutes les parties de la fenêtre et de la fenêtre parente qui doivent être redessinées.

MoveWindow envoie les messages WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED, WM_MOVE, WM_SIZE et WM_NCCALCSIZE à la fenêtre.

Exemples

Pour obtenir un exemple, consultez Création, énumération et dimensionnement de windows enfants.

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-1 (introduit dans Windows 8.1)