Função MoveWindow (winuser.h)

Artigo
03/04/2024

Altera a posição e as dimensões da janela especificada. Para uma janela de nível superior, a posição e as dimensões são relativas ao canto superior esquerdo da tela. Para uma janela filho, elas são relativas ao canto superior esquerdo da área de cliente da janela pai.

Sintaxe

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

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela.

[in] X

Tipo: int

A nova posição do lado esquerdo da janela.

[in] Y

Tipo: int

A nova posição do topo da janela.

[in] nWidth

Tipo: int

A nova largura da janela.

[in] nHeight

Tipo: int

A nova altura da janela.

[in] bRepaint

Tipo: BOOL

Indica se a janela deve ser repintada. Se esse parâmetro for TRUE, a janela receberá uma mensagem. Se o parâmetro for FALSE, nenhum repositório de nenhum tipo ocorrerá. Isso se aplica à área do cliente, à área não cliente (incluindo a barra de título e as barras de rolagem) e a qualquer parte da janela pai descoberta como resultado da movimentação de uma janela filho.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se o parâmetro bRepaint for TRUE, o sistema enviará a mensagem WM_PAINT para o procedimento de janela imediatamente após mover a janela (ou seja, a função MoveWindow chamará a função UpdateWindow ). Se bRepaint for FALSE, o aplicativo deverá invalidar ou redesenhar explicitamente todas as partes da janela e da janela pai que precisem ser redesenhadas.

MoveWindow envia as mensagens WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED, WM_MOVE, WM_SIZE e WM_NCCALCSIZE para a janela.

Exemplos

Para obter um exemplo, consulte Criando, enumerando e dimensionando janelas filho.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-window-l1-1-1 (introduzido em Windows 8.1)