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


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

Извлекает координаты клиентской области окна. Координаты клиента указывают левый верхний и нижний правый углы клиентской области. Так как координаты клиента относятся к левому верхнему углу клиентской области окна, координаты левого верхнего угла — (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