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

Статья
03/15/2023

Функция PtInRect определяет, находится ли указанная точка в указанном прямоугольнике. Точка находится внутри прямоугольника, если она находится на левой или верхней стороне или находится в пределах всех четырех сторон. Точка справа или внизу считается за пределами прямоугольника.

Синтаксис

BOOL PtInRect(
  [in] const RECT *lprc,
  [in] POINT      pt
);

Параметры

[in] lprc

Указатель на структуру RECT , содержащую указанный прямоугольник.

[in] pt

Структура POINT , содержащая указанную точку.

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

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

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

Перед вызовом PtInRect прямоугольник должен быть нормализован. То есть lprc.right должен быть больше lprc.left, а lprc.bottom — больше lprc.top. Если прямоугольник не нормализован, точка никогда не учитывается внутри прямоугольника.

Поскольку приложения могут использовать прямоугольники для различных целей, функции прямоугольника не используют явную единицу измерения. Вместо этого все координаты и измерения прямоугольника задаются в виде логических значений со знаком. Режим сопоставления и функция, в которой используется прямоугольник, определяют единицы измерения.

Примеры

Пример см. в разделе Использование прямоугольников.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll