CRect

CRect 类与 W indows RECT 结构相似，并且还包括操作 CRect 对象和 W indows RECT 结构的成员函数。

在传递 LPRECT ,LPCRECT 或 RECT 结构作为参数的任何地方，都可以传递

CRect 对象来代替。

注意这个类是从 tagRECT 结构派生而来的。（ tagRECT 是 RECT 结构的不太常用的别名。）这意味着 RECT 结构的数据成员（ left ， top ， right ，和 bottom ）也是 CRect 的可访问数据成员。

一个 CRect 包含用于定义矩形的左上角和右下角点的成员变量。

当指定一个 CRect 时，必须谨慎地构造它，以使它符合规范 – – – 也就是说，使其左坐标值小于右坐标值，使顶坐标值小于底坐标值。例如，左上角为（ 10 ， 10 ），右下角为（ 20 ， 20 ）就定义了一个符合规范的矩形，但是左上角为（ 20 ，

20 ）而右下角为（ 10 ， 10 ）的值就定义了一个不符合规范的矩形。如果矩形是不符合规范的，则 CRect 的许多成员函数都会符合不正确的结果。（参见CRect ::NormalizeRect 可以得到这些函数的列表。）在你调用一个要求符合规范的矩形的函数之前，你可以通过调用 N o rmalizeRect 函数来使不符合规范的矩形成为符合规范的矩形。

当用成员函数 CDC::DPtoLP 和 CDC::LPtoDP 来处理 CRect 时要小心。如果显示环境的映射模式 y-extent 是负的，就像在 MM_LOENGLISH 中一样，则CDC ::DPtoLP 将转换 CRect ，以使它的顶部坐标大于底部坐标。然后像 Height 和 Size 这样的函数将返回负值作为转换后的矩形的高度，则此矩形将是不符合

规范的。

当使用重载的 CRect 操作符时，第一个操作数必须是一个 CRect ；第二个操作数可以是一个 RECT 结构或一个 CRect 对象。

include < afxwin.h >

请参阅 CPoint ， CSize ， RECT

CRect 类成员

构造

Crect 构造一个 Crect 对象

运算
W idth	计算	CRect 的宽度
Height	计算	CRect 的高度
Size	计算	CRect 的大小

续表

TopLeft 返回 CRect 的左上角点

BottomRigh 返回 CRect 的右下角点

CenterPoint 返回 CRect 的中心点

IsRectEmpty 确定 CRect 是否是空的。如果 CRect 的宽度和 /或

高度为 0 ，则它是空的

IsRectNull 确定 CRect 的 top ， bottom ， left，和 right 是否都等于 0

PtInRect 确定指定的点是否在 CRect 之内

SetRect 设置 CRect 的尺寸

SetRectEmpty 设置 CRect 为一个空的矩形（所有的坐标都等于

0 ）

CopyRect 将一个源矩形的尺寸拷贝到 CRect

EqualRect 确定 CRect 是否等于给定的矩形

InflateRect 增加 CRect 的宽度和高度

DeflateRect 减少 CRect 的宽度和高度NormalizeRect 使 CRect 的高度和宽度返回规范O ffsetRect 将 CRect 移动到指定的偏移

SubtractRect 从一个矩形中减去另一个矩形

IntersectRect 设置 CRect 等于两个矩形的交集

UnionRect 设置 CRect 等于两个矩形的并集

运算符

Operator LPCRECT 将一个 CRect 转换为一个 LPCRECT Operator LPRECT 将一个 CRect 转换为一个 LPRECT Operator = 将一个矩形的尺寸拷贝到 CRect

Operator == 确定 CRect 是否与一个矩形相等

Operator != 确定 CRect 是否不等于另一个矩形

Operator += 使 CRect 增加指定的偏移，或使 CRect 放大

Operator -= 从 CRect 中减去指定的偏移，或缩小 CRect

Operator &= 设置 CRect 等于 CRect 和某个矩形的交

Operator |= 设置 CRect 等于 CRect 和某个矩形的并

Operator + 增加给定偏移量到 CRect ，并返回得到的 CRect

对象

Operator – 从 CRect 中减去给定偏移量，并返回得到的 CRect

对象

O perator & 创建 CRect 与某个矩形的交，并返回得到的 CRect

对象

Operator | 创建 CRect 与某个矩形的并，并返回得到的 CRect

对象

成员函数

CRect::BottomRight

CPoint& BottomRight( );

const CPoint& BottomRight( ) const;

返回值

返回矩形的右下角点的坐标。

说明

返回的右下角坐标是一个指向 CPoint 对象的引用，该对象包含在 CRect 对象中。

可以使用这个函数来获取或设置矩形的右下角坐标。要用这个函数来设置右下角。可以将此函数放在赋值操作符的左边。

请参阅 CRect::TopLeft, CPoint, CRect::CenterPoint

CRect::CenterPoint CPoint CenterPoint() const; 返回值

返回一个 CPoint 对象，该对象是 CRect 的中心点。

说明

要计算 CRect 的中心点，将其左、右坐标值相加再除 2 ，将其上、下值相加再除 2 。

请参阅 CRect::Width, CRect::Height, CRect::Size, CRect::TopLeft,

CRect::BottomRight,

CRect::IsRectNull, CPoint

CRect::CopyRect

void CopyRect( LPCRECT lpSrcRect );

参数

lpSrcRect

指向要拷贝的 RECT 结构或 CRect 对象的指针。

说明

此成员函数用来将 lpSrcRect 矩形拷贝到 CRect 中。

请参阅 CRect::CRect, CRect::operator =, CRect::SetRect, CRect::SetRectEmpty

CRect::CRect

CRect( );

CRect( int l, int t , int r , int b );

CRect( const RECT& srcRect ); CRect( LPCRECT lpSrcRect ); CRect( POINT point, SIZE size );

CRect( POINT topLeft , POINT bottomRight );

参数

指定 CRect 的左边位置。

指定 CRect 的上边位置。

指定 CRect 的右边位置。

指定 CRect 的底部位置。

srcRect

对指定的 CRect 对象的坐标的 RECT 结构的引用。

lpSrcRect

指向给定的 CRect 对象的坐标的 RECT 结构。

point

指定要构造的矩形的原点。该参数值对应于矩形的左上角。

size

指定要构造的矩形的从左上角到右下角的偏移量。

topLeft

指定 CRect 的左上角位置。

bottomRight

指定 CRect 的右下角位置。

说明

此成员函数用来构造一个 CRect 对象。如果没有给出参数，则不初始化 left，top ， righ t，和 bottom 成员。

CRect(const RECT& )和 CRect( LP RECT ) 构造函数指向一个 CopyRect 。其它的构造函数直接初始化对象的成员变量。

请参阅 CRect::SetRect, CRect::CopyRect, CRect::operator =, CRect::SetRectEmpty

CRect::DeflateRect

void DeflateRect( int x , int y ); void DeflateRect( SIZE size );

void DeflateRect( LPCRECT lpRect );

void DeflateRect( int l , int t , int r , int b );

参数

指定缩小 CRect 的左和右边的单位数。

指定缩小 CRect 的上、下边的单位数。

size

一个指定缩小 CRect 的单位数的 SIZE 或 CSize 。 cx 值指定缩小左、右边的单位数， cy` ` 指定缩小上、下边的单位数。

lpRect

指向一个 RECT 结构或 CRect ，指定缩小每一边的单位数。

指定缩小 CRect 左边的单位数。

指定缩小 CRect 上边的单位数。

指定缩小 CRect 右边的单位数。

指定缩小 CRect 下边的单位数。

DeflateRect 通过将 CRect 的边向其中心移动来缩小它。为了做到这一点， DeflateRect 将单位数增加到矩形的左边和上边，从右边和下边减去单位数。DeflateRect 的参数是有符号的值；正值缩小 CRect ，而负值则放大它。

前两个重载函数使 CRect 相对的两对边都缩小，因此 CRect 的总宽度减小了两倍 x （或 cx ），总高度减小了两倍 y （或 cy ）。其它两个重载函数使 CRect 的边相对独立的缩小。

请参阅 CRect::InflateRect, CRect::operator -, CRect::operator -=, ::InflateRect

CRect::EqualRect

BOOL EqualRect( LPCRECT lpRect ) const;

如果两个矩形具有相同的上、左、下、右边值，则返回非零值；否则返回 0 。

注意两个矩形都必须是符合规范的，否则此函数将失败。你可以在调用此函数之前，调用 NormalizeRect 来使矩形规范化。

参数

lpRect

指向一个 RECT 结构或 CRect 对象，该对象或结构包含了一个矩形的左上角和右下角的坐标。

请参阅 CRect::operator ==, CRect::operator !=, CRect::NormalizeRect, ::EqualRect

int Height() const;

返回值

返回 CRect 的高度。

说明

此成员函数通过从 CRect 的下边值中减去上边值来计算 CRect 的高度。结果值可以是负数。

注意这个矩形必须是符合规范的，否则此函数将失败。你可以在调用此函数之前，调用 NormalizeRect 来使矩形规范化。

请参阅 CRect::Width, CRect::Size, CRect::CenterPoint, CRect::IsRectEmpty, CRect::IsRectNull, CRect::NormalizeRect

void InflateRect( int x , int y ); void InflateRect( SIZE size );

void InflateRect( LPCRECT lpRect ); void InflateRect( int l , int t , int r , int b );

参数

指定扩大 CRect 左和右边的单位数。

指定扩大 CRect 上、下边的单位数。

size

一个指定扩大 CRect 的单位数的 SIZE 或 CSize 。 cx 值指定扩大左、右边的单位数， cy 指定扩大上、下边的单位数。

lpRect

指向一个 RECT 结构或 CRect ，指定扩大每一边的单位数。

指定扩大 CRect 左边的单位数。

指定扩大 CRect 上边的单位数。

指定扩大 CRect 右边的单位数。

指定扩大 CRect 下边的单位数。

说明

InflateRect 通过将 CRect 的边向远离其中心的方向移动来扩大它。为了做到这一点， In flateRect 从矩形的左边和上边减去单位数，将单位数增加到右边和下

边。 In flateRect 的参数是有符号的值；正值扩大 CRec t，而负值则缩小它。

前两个重载函数使 CRect 相对的两对边都扩大，因此 CRect 的总宽度增加了了两倍 x （或 cx ），总高度增加了两倍 y （或 cy ）。其它两个重载函数使 CRect 的边则是相对独立的扩大。

请参阅 CRect::DeflateRect, CRect::operator +, CRect::operator +=, ::InflateRect

CRect::IntersectRect

BOOL IntersertRect ( LPCRECT lpRect1 , LPCRECT lpRect2 );

返回值

如果交不为空，则返回非零值；否则，如果交为空则返回 0 。

参数

lpRect1

指向一个 RECT 结构或 CRect 对象，该对象或结构包含了一个源矩形。

lpRect2

指向一个 RECT 结构或 CRect 对象，该对象或结构包含了一个源矩形。

说明

此函数使 CRect 等于两个现有矩形的交。交是同时包含在两个现有矩形中的最大矩形。

注意两个矩形都必须是符合规范的，否则此函数将失败。你可以在调用此函数之前，调用 NormalizeRect 来使矩形规范化。

请参阅 CRect::operator &=, CRect::operator &, CRect::UnionRect,

CRect::SubtractRect,

CRect::NormalizeRect, ::IntersectRect

CRect::IsRectEmpty BOOL IsRectEmpty() const; 返回值

如果 CRect 是空的则返回非零值；否则，如果 CRect 不是空的则返回 0 。

说明

此函数用来确定 CRect 是否是空的。如果一个矩形的宽度和 /或高度是 0 或负值，则称这个矩形为空的。与 IsRectNull 不同， IsRectNull 用来确定是否矩形的所有坐标都是零。

注意这个矩形必须是符合规范的，否则此函数将失败。你可以在调用

此函数之前，调用 NormalizeRect 来使矩形规范化。

请参阅 CRect::IsRectNull, CRect::SetRectEmpty, CRect::NormalizeRect, ::IsRectEmpty

CRect::IsRectNull BOOL IsRectNull() const; 返回值

如果 CRect 的上、左、下和右边的值都等于 0 ，则返回非零值；否则返回 0 。

说明

此函数用来确定 CRect 的上、左、下和右边的值是否都等于 0 。与 IsRectEmpty

不同， IsRectEmpty 用来确定矩形是否为空。

请参阅 CRect::IsRectEmpty, CRect::SetRectEmpty

CRect::NormalizeRect void NormalizeRect( ); 说明

此函数用来使 CRect 符合规范，使其高度和宽度均为正值。矩形被从四个象限规范化，通常这四个象限就是 W indows 用来确定坐标的。 NormalizeRect 比较上、下坐标的值，如果上坐标值大于下坐标的值，则将它们互换。类似的，如果左坐标的值大于右坐标的值，则将左、右坐标互换。当处理不同的映射模式和转化的矩形时，这个函数是很有用的。

注意下面的 CRect 成员函数为了正确地工作，需要规范化的矩形，它们是： Height ， Width ， Size ， IsRectEmpty ， PtInRect ， EqualRect ，

UnionRect ， IntersectRect， SubtractRect ， operator == ， operator != ， operator | ， operator |=， operator & ，和 operator &= 。

CRect:: OffsetRect

void OffsetRect( int x , int y ); void OffsetRect( POINT point ); void OffsetRect( SIZE size );

参数

指定要往左或右移动的数量。要往左时此值必须是负值。

指定要往上或下移动的数量。要往上时此值必须是负值。

point

包含一个 POINT 结构或 CPoint 对象，该结构或对象指定了要移动的尺寸。

size

包含一个 SIZE 结构或 CSize 对象，指定要移动的尺寸。

说明

此函数用来将 CRect 移动指定的偏移量。将 CRect 沿 x 轴移动 x 个单位，沿 y 轴移动 y 个单位。 x 和 y 参数都是有符号的值，因此 CRect 可以向左或向右，向上或向下移动。

请参阅 CRect::operator +, CRect::operator +=, CRect::operator -, CRect::operator -

CRect

CRect

CRect 类 成 员

成 员 函 数

CRect 类成员

成员函数