winuser.h


MoveWindow

La función MoveWindow cambia la posición y dimensiones de la ventana especificada. Para una ventana de primer nivel, la posición y dimensiones son relativas a la esquina superior izquierda de la pantalla. Para una ventana hija, son relativas a la esquina superior izquierda del área de cliente de la ventana padre.

Sintaxis

BOOL MoveWindow(
    HWND hWnd,     // manipulador de ventana
    int X,         // posición horizontal
    int Y,         // posición vertical
    int nWidth,    // anchura
    int nHeight,   // altura
    BOOL bRepaint  // bandera de repintado
   );

Parámetros

hWnd: identifica la ventana.

X: especifica la nueva posición del lado izquierdo de la ventana.

Y: especifica la nueva posición de la parte superior de la ventana.

nWidth: especifica la nueva anchura de la ventana.

nHeight: especifica la nueva altura de la ventana.

bRepaint: especifica si la ventana debe ser redibujada. Si este parámetro es TRUE, la ventana recinirá un mensaje WM_PAINT. Si el parámetro es FALSE, no se producirá ningún tipo de repintado. Esto se aplica al área de cliente, al área de no cliente (incluyendo la barra de título y las barras de scroll), y cualquier parte de la ventana padre no cubierta como resultado del movimiento de una ventana hija. Si este parámetro es FALSE, la aplicación debe invalidar explícitamente o redibujar cualquier parte de la ventana y de la ventana padre que necesite actualizarse.

Valor de retorno

Si la función tiene éxito, el valor de retorno será distinto de cero.

Si la función falla, el valor de retorno es cero.

Observaciones

Si el parámetro bRepaint es TRUE, Windows envía el mensaje WM_PAINT al procedimiento de ventana inmediatamente después de mover la ventana (es decir, la función MoveWindow llama a la función UpdateWindow). Si bRepaint es FALSE, Windows coloca el mensaje WM_PAINT en la cola asociada con la ventana. El bucle de mensajes procesará el mensaje WM_PAINT sólo después de cualquier otro mensaje en la cola.

MoveWindow envía mensajes WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED, WM_MOVE, WM_SIZE y WM_NCCALCSIZE a la ventana.