Поделиться через


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

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

Синтаксис

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)

См. также

Концептуальный

GetClientRect

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

ScreenToClient

SetWindowPos

Windows