Функция MoveWindow (winuser.h)

Статья
08/27/2023

Изменяет положение и размеры указанного окна. Для окна верхнего уровня положение и размеры находятся относительно левого верхнего угла экрана. Для дочернего окна они находятся относительно левого верхнего угла клиентской области родительского окна.

Синтаксис

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

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна.

[in] X

Тип: int

Новое положение левой части окна.

[in] Y

Тип: int

Новое положение верхней части окна.

[in] nWidth

Тип: int

Новая ширина окна.

[in] nHeight

Тип: int

Новая высота окна.

[in] bRepaint

Тип: BOOL

Указывает, нужно ли перекрасить окно. Если этот параметр имеет значение TRUE, окно получает сообщение. Если параметр имеет значение FALSE, то никакой перерисовки не происходит. Это относится к клиентской области, неклиентской области (включая заголовок и полосы прокрутки) и любой части родительского окна, обнаруженной в результате перемещения дочернего окна.

Возвращаемое значение

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Если параметр bRepaint имеет значение TRUE, система отправляет WM_PAINT сообщение в процедуру окна сразу после перемещения окна (то есть функция MoveWindow вызывает функцию UpdateWindow ). Если параметр bRepaint имеет значение FALSE, приложение должно явно сделать недействительными или перерисовывать все части окна и родительского окна, которые требуют перерисовки.

MoveWindow отправляет в окно сообщения WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED, WM_MOVE, WM_SIZE и WM_NCCALCSIZE .

Примеры

Пример см. в разделе Создание, перечисление и изменение размера дочерних окон.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-1 (представлено в Windows 8.1)