Función MoveWindow (winuser.h)

Artículo
03/13/2024

Cambia la posición y las dimensiones de la ventana especificada. Para una ventana de nivel superior, la posición y las dimensiones son relativas a la esquina superior izquierda de la pantalla. Para una ventana secundaria, son relativas a la esquina superior izquierda del área cliente de la ventana primaria.

Sintaxis

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

Parámetros

[in] hWnd

Tipo: HWND

Un identificador de la ventana.

[in] X

Tipo: int

Especifica la nueva posición del lado izquierdo de la ventana.

[in] Y

Tipo: int

Nueva posición de la parte superior de la ventana.

[in] nWidth

Tipo: int

Nuevo ancho de la ventana.

[in] nHeight

Tipo: int

Nuevo alto de la ventana.

[in] bRepaint

Tipo: BOOL

Indica si se va a volver a pintar la ventana. Si este parámetro es TRUE, la ventana recibe un mensaje. Si el parámetro es FALSE, no se produce ninguna repetición de ningún tipo. Esto se aplica al área cliente, al área que no es cliente (incluida la barra de título y las barras de desplazamiento) y a cualquier parte de la ventana primaria que se descubre como resultado de mover una ventana secundaria.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si el parámetro bRepaint es TRUE, el sistema 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, la aplicación debe invalidar o volver a dibujar explícitamente las partes de la ventana y la ventana primaria que necesiten volver a dibujar.

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

Ejemplos

Para obtener un ejemplo, vea Crear, enumerar y cambiar el tamaño de las ventanas secundarias.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-1 (introducido en Windows 8.1)