操作符

CRect::PtInRect

BOOL PtInRect( POINT point ) const;

返回值

如果点位于 CRect 中，则返回非零值；否则返回 0 。

参数

point

包含一个 POINT 结构或 CPoint 对象。

说明

此函数用来确定一个指定的点是否在 CRect 内。如果这个点在 CRect 的左边和上边上，或在四个边之内，则称此点在 CRect 之内。点在 CRect 的右边或底边上，则称点在 CRect 外。

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

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

请参阅 CRect::NormalizeRect, ::PtInRect

CRect::SetRect

void SetRect( int x1 , int y1 , int x2 , int y2 );

参数

指定左上角的 x 坐标。

指定左上角的 y 坐标。

指定右下角的 x 坐标。

指定右下角的 y 坐标。

说明

此函数将 CRect 的各个坐标设置为指定的坐标值。

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

CRect::SetRectEmpty

void SetRectEmpty();

说明

此函数通过将 CRect 的所有坐标设置为零来使 CRect 成为一个空矩形。

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

CRect::Size CSize Size() const; 返回值

返回一个包含 CRect 的尺寸的 CSize 对象。

说明

返回值的 cx 和 cy 成员包含了 CRect 的高度和宽度。高度和宽度都可以是负值。

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

请参阅 CRect::Height, CRect::Width, CRect::IsRectEmpty, CRect::IsRectNull,

CRect::SubtractRect

BOOL SubtractRect( LPCRECT lpRectSrc1 , LPCRECT lpRectSrc2 );

返回值

如果函数成功则返回非零值；否则返回 0 。

参数

lpRectSrc1

指向一个 RECT 结构或 CRect 对象，将从这个结构或对象中减去某个矩形。

lpRectSrc2

指向一个 RECT 结构或 CRect 对象，将从由 lpRectSrc1 参数指定的矩形中减去这个结构或对象。

说明

该函数使一个 CRect 对象的尺寸等于从 lpRectSrc1 中减去 lpRectSrc2 的差，这个差值是一个包含所有在 lpRectScr1 内，而不在 lpRectScr1 和 lpRectScr2 的交之中的点的最小矩形。

如果由 lpRectScr2 指定的矩形和由 lpRectScr1 指定的矩形没有在 x 或 y 方向之一的方向上重叠，则由 lpRectScr1 指定的矩形将没有改变。

例如，如果 lpRectScr1 是（ 10 ， 10 ， 100 ， 100 ）， lpRectScr2 是（ 50 ， 50 ， 150 ， 150 ，）则当函数返回时，由 lpRectScr1 指定的矩形将没有改变。如果 lpRectScr1 是（ 10 ， 10 ， 100 ， 100 ，）， lpRectScr2 是（ 50 ， 10 ， 150 ， 150 ），则当函数返回时，由 lpRectScr1 指定的矩形将包含坐标（ 10 ， 10 ， 50 ， 100 ）。

SubtractRect 与操作符 - 和操作符 -= 是不一样的。这两个操作符都不调用

SubtractRect。

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

请参阅 CRect::operator -, CRect::operator -=, CRect::IntersectRect, CRect::UnionRect,

CRect::NormalizeRect, ::SubtractRect

CRect::TopLeft

CPoint& TopLeft( );

const CPoint& TopLeft( ) const;

返回值

返回矩形的左上角坐标。

此函数返回的坐标是一个对 CPoint 对象的引用，该对象包含在 CRect 中。

你可以使用此函数来获取或设置矩形的左上角。通过在赋值操作符的左边使用这个函数，可以设置矩形的左上角。

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

CRect::UnionRect

BOOL UnionRect( LPCRECT lpRect1 , LPCRECT lpRect2 );

返回值

如果两个矩形的并不是空，则返回非零值；否则，如果并是空，则返回 0 。

lpRect1

指向一个 RECT 或 CRect ，包含了一个源矩形。

lpRect2

指向一个 RECT 或 CRect ，包含了一个源矩形。

说明

此函数使 CRect 的尺寸等于两个源矩形的并。并就是包含两个源矩形的最小矩形。 Windows 忽略空矩形，即没有高度也没有宽度的矩形。

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

请参阅 CRect::operator |=, CRect::operator |, CRect::IntersectRect, CRect::SubtractRect,

CRect:: W idth int W idth() const; 返回值

返回 CRect 的宽度。

说明

此函数用右坐标值减去左坐标值，来计算 CRect 的宽度。这个宽度可以是负值。

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

请参阅 CRect::Height, CRect::Size, CRect::CenterPoint, CRect::IsRectEmpty,

CRect::operator LPCRECT operator LPCRECT( ) const; 说明

此操作符将一个 CRect 转化为一个 LPCRECT 。当使用此函数时，不需要使用地址操作符（ & ）。当你传递一个 CRect 对象给一个需要 LPCRECT 的函数时，此操作符被自动使用。

请参阅 CRect::operator LPRECT

CRect::operator LPRECT

Operator LPRECT();

说明

此操作符将一个 CRect 转化为一个 LPRECT 。当使用此函数时，不需要使用地址操作符（ & ）。当你传递一个 CRect 对象给一个需要 LPRECT 的函数时，此操作符被自动使用。

请参阅 CRec t::operator LPCRECT

CRect:: operator =

void operator =( const RECT& srcRect );

参数

srcRect

指向一个源矩形。可以是一个 RECT 或 CRect 。

说明

此操作符将 srcRect 分配给 CRect 。

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

CRect:: operator ＝＝

BOOL operator ==( const RECT& rect ) const;

返回值

如果相等则返回非零值；否则返回 0 。

参数

rect

指向一个源矩形。可以是一个 RECT 或 CRect 。

说明

此操作符通过比较 rect 与 CRect 左上角和右下角的坐标值来确定它们是否相等。

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

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

CRect:: operator !=

BOOL operator !=( const RECT& rect ) const;

返回值

如果不相等则返回非零值；否则返回 0 。

参数

rect

指向一个源矩形。可以是一个 RECT 或 CRect 。

说明

此操作符通过比较 rect 与 CRect 左上角和右下角的坐标值来确定它们是否不相等。

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

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

CRect:: operator +=

void operator +=( POINT point ); void operator +=( SIZE size );

void operator +=( LPCRECT lpRect );

参数

point

一个 POINT 结构或 CPoint 对象，指定了矩形要移动的单位数。

size

一个 SIZE 结构或 CSize 对象，指定了矩形要移动的单位数。

lpRect

指向一个 RECT 或 CRect 对象，包含了要扩大 CRect 的每一边的单位数。

说明

前两种重载形式将 CRect 移动指定的偏移量。参数的 x 和 y （或 cx 和 cy ）被增加到 CRect 。

第三种重载形式将 CRect 扩大参数中每一个成员所指定的单位数。

请参阅 CRec t::OffsetRect, CRect::InflateRect, CRect::operator +, CRect::operator

CRect:: operator -=

void operator -= ( POINT point ); void operator -= ( SIZE size );

void operator - = ( LPCRECT lpRect );

参数

point

一个 POINT 结构或 CPoint 对象，指定了矩形要移动的单位数。

size

一个 SIZE 结构或 CSize 对象，指定了矩形要移动的单位数。

lpRect

指向一个 RECT 或 CRect 对象，包含了要扩大 CRect 的每一边的单位数。

说明

前两种重载形式将 CRect 移动指定的偏移量。从 CRect 中减去参数的 x 和 y（或

cx 和 cy ）。

第三种重载形式将 CRect 缩小参数中每一个成员所指定的单位数。注意，这个重载函数像 DeflateRet 。

请参阅 CRect::OffsetRect, CRect::DeflateRect, CRect::SubtractRect,

CRect::operator -,

CRect::operator +=

CRect:: operator &=

void operator &=( const RECT& rect );

参数

rect

包含一个 RECT 或 CRect 。

说明

此操作符用来使 CRect 等于 CRect 和 rect 的交。交是被两个源矩形都包含的最大矩形。

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

请参阅 CRect::operator & , CRect::operator |=, CRect::IntersectRect, CRect::NormalizeRect, ::IntersectRect

CRect:: operator |=

void operator |=( const RECT& rect );

参数

rect

包含一个 RECT 或 CRect 。

说明

此操作符用来使 CRect 等于 CRect 和 rect 的并。并是包含两个源矩形的最小矩

形。

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

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

CRect:: operator +

CRect operator +( POINT point ) const; CRect operator +( LPCRECT lpRect ) const; CRect operator +( SIZE size ) const;

返回值

返回一个 CRect ，它是将 CRect 移动或扩大参数中指定的单位数之后的结果。

参数

point

一个 POINT 结构或 CPoint 对象，指定了返回值要移动的单位数。

size

一个 SIZE 结构或 CSize 对象，指定了返回值要移动的单位数。

lpRect

指向一个 RECT 或 CRect 对象，包含了要扩大返回值的每一边的单位数。

说明

前两种重载形式返回的 CRect 对象是 CRect 移动指定偏移后的结果。参数的 x

和 y （或 cx 和 cy ）被增加到 CRect 的位置上。

第三种重载形式返回一个新的 CRect 对象，此对象是扩大了参数的每一个成员指定的单位数之后的 CRect 。

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

CRect:: operator -

CRect operator – ( POINT point ) const; CRect operator – ( SIZE size ) const;

CRect operator – ( LPCRECT lpRect ) const;

返回值

返回一个 CRect ，它是将 CRect 移动或缩小参数中指定的单位数之后的结果。

参数

point

一个 POINT 结构或 CPoint 对象，指定了返回值要移动的单位数。

size

一个 SIZE 结构或 CSize 对象，指定了返回值要移动的单位数。

lpRect

指向一个 RECT 或 CRect 对象，包含了要扩大返回值的每一边的单位数。

说明

前两种重载形式返回的 CRect 对象是 CRect 移动指定偏移后的结果。参数的 x

和 y （或 cx 和 cy ）被从 CRect 的位置上减去。

第三种重载形式返回一个新的 CRect 对象，此对象是缩小了参数的每一个成员指定的单位数之后的 CRect 。注意，这个重载函数类似于 DeflateRect，而不是SubtractRect。

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

CRect::SubtractRect

CRect:: operator &

CRect operator &( const RECT& rect2 ) const;

返回值

返回一个 CRect ，它是 CRect 和 rect2 的交。

参数

rect2

包含一个 RECT 或 CRect 。

说明

此操作符返回一个 CRec t，它是 CRect 和 rect2 的交。交是被两个矩形包含的最大矩形。

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

请参阅 CRect::IntersectRect, CRect::operator &=, CRect::operator |, CRect::NormalizeRect

CRect:: operator |

CRect operator |( const RECT& rect2 ) const;

返回值

返回一个 CRect ，它是 CRect 和 rect2 的并。

参数

rect2

包含一个 RECT 或 CRect 。

说明

此操作符返回一个 CRec t，它是 CRect 和 rect2 的并。并是包含两个矩形的最小矩形。

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

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

操 作 符

操 作 符

操作符

操作符