CRect::SubtractRect

BOOL SubtractRect ( LPCRECT lpRectSrc1, LPCRECT lpRectSrc2 );

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

Ненулевое значение, если функция выполнена успешно; в противном случае 0.

Параметры

lpRectSrc1

Указывает на структуру RECT или CRect объект, из которого вычитается прямоугольник.

lpRectSrc2

Указывает на структуру RECT или CRect объект, который должен быть вычтен из прямоугольника, который указывает параметр lpRectSrc1.

Примечания

Делает размеры lpRectSrc1 прямоугольника равна вычитания lpRectSrc2 от lpRectSrc1. Вычитание имеет наименьший прямоугольник, содержащий все точки в lpRectScr1 , которые не находятся в lpRectScr1 и lpRectScr2.

Прямоугольник, задаваемый lpRectSrc1 будет неизменным, если прямоугольник, задаваемый lpRectSrc2 не полностью перекрываются прямоугольник, задаваемый lpRectSrc1 хотя бы в одном из x - и y направлений.

Например, если были lpRectSrc1 (10,10, 100,100) и lpRectSrc2 (50,50, 150,150), прямоугольник, который указывает lpRectSrc1 будет неизменным, когда функция вернулся. Если бы lpRectSrc1 (10,10, 100,100) и lpRectSrc2 (50,10, 150,150), однако, прямоугольник, который указывает lpRectSrc1 будет содержать координаты (10,10, 50,100) когда вернулся функция.

SubtractRect не является таким же, как оператор - ни оператор-=. Ни один из этих операторов постоянно называет SubtractRect.

Примечаниеnbsp;  Оба из прямоугольников должна быть нормализована или эта функция может завершиться неудачей. Вы можете вызвать &NormalizeRect для нормализации прямоугольники перед вызовом этой функции.

Обзор CRectЧлены класса | Иерархическая схема

См. такжеnbsp;CRect::operator-, CRect::operator-=, CRect::IntersectRect, CRect::UnionRect, CRect::&NormalizeRect, :: SubtractRect

Index