MoveWindow
The MoveWindow
function changes the position and dimensions of the specified window. For a
top-level window, the position and dimensions are relative to the upper-left
corner of the screen. For a child window, they are relative to the upper-left
corner of the parent window s client area.
BOOL MoveWindow(
|
HWND hWnd, |
// handle of window |
|
int X, |
// horizontal
position |
|
int Y, |
// vertical
position |
|
int nWidth, |
// width |
|
int nHeight, |
// height |
|
BOOL bRepaint |
// repaint flag |
|
); |
|
Parameters
hWnd
Identifies
the window.
X
Specifies the
new position of the left side of the window.
Y
Specifies the
new position of the top of the window.
nWidth
Specifies the
new width of the window.
nHeight
Specifies the
new height of the window.
bRepaint
Specifies
whether the window is to be repainted. If this parameter is TRUE, the window
receives a WM_PAINT
message. If the parameter is FALSE, no repainting of any kind occurs. This
applies to the client area, the nonclient area (including the title bar and
scroll bars), and any part of the parent window uncovered as a result of moving
a child window. If this parameter is FALSE, the application must explicitly
invalidate or redraw any parts of the window and parent window that need redrawing.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero.
Remarks
If the bRepaint
parameter is TRUE, Windows sends the WM_PAINT message to the window procedure
immediately after moving the window (that is, the MoveWindow function
calls the UpdateWindow function). If bRepaint is FALSE, Windows
places the WM_PAINT message in the message queue associated with the window.
The message loop dispatches the WM_PAINT message only after dispatching all
other messages in the queue.
MoveWindow sends WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED, WM_MOVE, WM_SIZE, and WM_NCCALCSIZE messages to the window.
See Also