Функция SubtractRect (winuser.h)
Функция SubtractRect определяет координаты прямоугольника, сформированного путем вычитания одного прямоугольника из другого.
Синтаксис
BOOL SubtractRect(
[out] LPRECT lprcDst,
[in] const RECT *lprcSrc1,
[in] const RECT *lprcSrc2
);
Параметры
[out] lprcDst
Указатель на структуру RECT , которая получает координаты прямоугольника, определяемые путем вычитания прямоугольника, на который указывает lprcSrc2 , из прямоугольника, на который указывает lprcSrc1.
[in] lprcSrc1
Указатель на структуру RECT , из которой функция вычитает прямоугольник, на который указывает lprcSrc2.
[in] lprcSrc2
Указатель на структуру RECT , которую функция вычитает из прямоугольника, на который указывает lprcSrc1.
Возвращаемое значение
Если результирующий прямоугольник пуст, возвращаемое значение равно нулю.
Если результирующий прямоугольник не пуст, возвращаемое значение не равно нулю.
Комментарии
Функция вычитает прямоугольник, заданный параметром lprcSrc2 , из прямоугольника, заданного параметром lprcSrc1 , только если прямоугольники полностью пересекаются в направлении x или y. Например, если *lprcSrc1 имеет координаты (10,10,100,100), а *lprcSrc2 имеет координаты (50,50,150,150), функция устанавливает координаты прямоугольника, на который указывает lprcDst значение (10,10,100,100). Если *lprcSrc1 имеет координаты (10,10,100,100), а *lprcSrc2 имеет координаты (50,10,150,150), функция устанавливает координаты прямоугольника, на который указывает lprcDst , значение (10,10,50,100). Другими словами, результирующий прямоугольник является ограничивающим прямоугольником геометрической разности.
Поскольку приложения могут использовать прямоугольники для разных целей, функции прямоугольника не используют явную единицу измерения. Вместо этого все координаты и измерения прямоугольника задаются в виде подписанных логических значений. Режим сопоставления и функция, в которой используется прямоугольник, определяют единицы измерения.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |