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

Статья
03/04/2024

Извлекает координаты клиентской области окна. Координаты клиента указывают левый верхний и нижний правый углы клиентской области. Так как координаты клиента относятся к левому верхнему углу клиентской области окна, координаты левого верхнего угла — (0,0).

Синтаксис

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

Параметры

[in] hWnd

Тип: HWND

Дескриптор для окна, координаты клиента которого должны быть извлечены.

[out] lpRect

Тип: LPRECT

Указатель на структуру RECT , получающую координаты клиента. Левый и верхний элементы равны нулю. Правые и нижние элементы содержат ширину и высоту окна.

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

Тип: BOOL

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

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

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

Примеры

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

Требования

Требование	Значение
Минимальная версия клиента	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)

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

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

GetWindowRect

Другие ресурсы

RECT

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

Windows

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