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

  • Статья

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

Синтаксис

BOOL GetWindowPlacement(
  [in]      HWND            hWnd,
  [in, out] WINDOWPLACEMENT *lpwndpl
);

Параметры

[in] hWnd

Тип: HWND

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

[in, out] lpwndpl

Тип: WINDOWPLACEMENT*

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

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

Тип: BOOL

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

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

Комментарии

Элемент флаговWINDOWPLACEMENT, полученный этой функцией, всегда равен нулю. Если окно, определенное параметром hWnd , развернуто, элемент showCmd SW_SHOWMAXIMIZED. Если окно свернуто, параметр showCmd SW_SHOWMINIMIZED. В противном случае это SW_SHOWNORMAL.

Элемент длины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-0 (появилось в Windows 8)

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

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

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

SetWindowPlacement

WINDOWPLACEMENT

Windows