Funzione MoveWindow (winuser.h)

Articolo
08/27/2023

Modifica la posizione e le dimensioni della finestra specificata. Per una finestra di primo livello, la posizione e le dimensioni sono relative all'angolo superiore sinistro dello schermo. Per una finestra figlio, sono relative all'angolo superiore sinistro dell'area client della finestra padre.

Sintassi

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

Parametri

[in] hWnd

Tipo: HWND

Handle nella finestra.

[in] X

Tipo: int

Nuova posizione del lato sinistro della finestra.

[in] Y

Tipo: int

Nuova posizione della parte superiore della finestra.

[in] nWidth

Tipo: int

Nuova larghezza della finestra.

[in] nHeight

Tipo: int

Nuova altezza della finestra.

[in] bRepaint

Tipo: BOOL

Indica se la finestra deve essere riinteduta. Se questo parametro è TRUE, la finestra riceve un messaggio. Se il parametro è FALSE, non si verifica alcuna ripainting di qualsiasi tipo. Ciò si applica all'area client, all'area nonclient (inclusa la barra del titolo e le barre di scorrimento) e a qualsiasi parte della finestra padre individuata come risultato dello spostamento di una finestra figlio.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se il parametro bRepaint è TRUE, il sistema invia il messaggio di WM_PAINT alla procedura della finestra immediatamente dopo lo spostamento della finestra, ovvero la funzione MoveWindow chiama la funzione UpdateWindow . Se bRepaint è FALSE, l'applicazione deve invalidare o ridisegnare in modo esplicito tutte le parti della finestra e della finestra padre che devono essere ridisegnate.

MoveWindow invia i messaggi WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED, WM_MOVE, WM_SIZE e WM_NCCALCSIZE alla finestra.

Esempio

Per un esempio, vedere Creazione, enumerazione e ridimensionamento di Windows figlio.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-1 (introdotto in Windows 8.1)