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

  • Статья

Задает состояние отображения и восстановленные, свернутые и развернутые позиции указанного окна.

Синтаксис

BOOL SetWindowPlacement(
  [in] HWND                  hWnd,
  [in] const WINDOWPLACEMENT *lpwndpl
);

Параметры

[in] hWnd

Тип: HWND

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

[in] lpwndpl

Тип: const WINDOWPLACEMENT*

Указатель на структуру WINDOWPLACEMENT , которая задает новое состояние отображения и позиции окна.

Перед вызовом SetWindowPlacement задайте для элемента длины структуры WINDOWPLACEMENT значение sizeof(WINDOWPLACEMENT). SetWindowPlacement завершается ошибкой , если член длины задан неправильно.

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

Тип: BOOL

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

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

Комментарии

Если информация, указанная в windowplacement , приведет к тому, что окно полностью отключается от экрана, система автоматически корректирует координаты таким образом, чтобы окно было видимым, учитывая изменения в разрешении экрана и конфигурации нескольких мониторов.

Элемент длиныWINDOWPLACEMENT должен иметь значение sizeof(WINDOWPLACEMENT). Если этот элемент задан неправильно, функция возвращает значение FALSE. Дополнительные замечания о правильном использовании координат размещения окна см. в разделе WINDOWPLACEMENT.

Требования

   
Минимальная версия клиента 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-3 (появилось в Windows 10 версии 10.0.10240)

См. также раздел

Основные понятия

GetWindowPlacement

Справочные материалы

WINDOWPLACEMENT

Windows