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

2025-04-11

Извлекает измерения ограничивающего прямоугольника указанного окна. Измерения задаются в координатах экрана, которые относятся к левому верхнему углу экрана.

Синтаксис

BOOL GetWindowRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect
);

Параметры

[in] hWnd

Тип: HWND

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

[out] lpRect

Тип: LPRECT

Указатель на структуру RECT , которая получает координаты экрана в левом верхнем и правом нижнем углу окна.

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

Тип: BOOL

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

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

Замечания

В соответствии с соглашениями для структуры RECT координаты в правом нижнем углу возвращаемого прямоугольника являются эксклюзивными. Другими словами, пиксель вправо, внизу находится непосредственно за пределами прямоугольника.

GetWindowRect виртуализирован для DPI.

В Windows Vista и более поздних версиях окно Rect теперь может включать невидимые границы изменения размера.

Чтобы получить видимые границы окна, не включая невидимые границы изменения размера, используйте DwmGetWindowAttribute, указав DWMWA_EXTENDED_FRAME_BOUNDS. Обратите внимание, что в отличие от прямоугольника окна, границы расширенных кадров DWM не настраиваются для DPI.

Примеры

Пример см. в разделе "Инициализация диалогового окна".

Требования

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