Функция SubtractRect

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

Синтаксис

Параметры

[out] Указатель на структуру RECT, которая получает координаты прямоугольника, определенного вычитанием прямоугольника, указанного при помощи параметра lprcSrc2 из прямоугольника, указанного при помощи параметра lprcSrc1.

[in] Указатель на структуру RECT, из которой функция вычитает прямоугольник, указанный при помощи параметра lprcSrc2.

[in] Указатель на структуру RECT, которую функция вычитает из прямоугольника, указанного при помощи параметра lprcSrc1.

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

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

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Функция только вычитает прямоугольник, указанный 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).

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

Смотри также

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