Функция PtInRect


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

Синтаксис

BOOL PtInRect(
  CONST RECT *lprc,  // rectangle
  POINT pt           // point
);

Параметры

lprc

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

pt

[in] Указывает на структуру POINT, которая содержит заданную точку.

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

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

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

Замечания

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

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

Демонстрационный код

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

Смотри также 

Обзор Прямоугольники, Функции, используемые прямоугольниками, EqualRect, IsRectEmpty, POINT, RECT


Размещение и совместимость PtInRect
К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.1 и выше
в   
е    
р    
Используемая библиотека User32.lib
Используемая DLL -
Заголовочный файл  
- объявлено в Winuser.h
- включено в Windows.h
Unicode Нет
Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz