《Windows API每日一练》4.6 矩形、区域和裁剪

在前面的4.3节中我们讲述了绘制矩形的API函数Rectangle和RoundRect。本节我们将介绍另外一组使用RECT矩形结构和区域的绘图函数。

本节必须掌握的知识点：

矩形

第28练：绘制随机矩形

矩形与区域的裁剪

第29练：区域裁剪

4.6.1 矩形

■FillRect函数

FillRect函数用于在指定的设备上下文（Device Context）中，用指定的画刷（Brush）填充一个矩形区域。FillRect函数的函数原型如下：

int FillRect(

HDC hDC, //指向目标设备上下文的句柄

const RECT *lprc, //指向RECT结构的指针，指定要填充的矩形区域

HBRUSH hbr //指向画刷的句柄，用于指定填充矩形的颜色和样式

);

函数返回一个非零值表示成功，返回零表示失败。

●以下是使用FillRect函数的示例代码：

HDC hdc = GetDC(hwnd); // 获取窗口的设备上下文

RECT rect;

HBRUSH hBrush;

SetRect(&rect, 100, 100, 200, 200); // 设置矩形的坐标

hBrush = CreateSolidBrush(RGB(255, 0, 0)); // 创建红色实心画刷

FillRect(hdc, &rect, hBrush); // 使用画刷填充矩形区域

DeleteObject(hBrush); // 删除画刷对象

ReleaseDC(hwnd, hdc); // 释放设备上下文

FillRect函数对于在设备上下文中绘制填充矩形非常有用，可以用于创建背景色、填充区域、绘制图形等操作。

■FrameRect函数

FrameRect函数用于绘制指定矩形区域的边框。函数原型如下：

BOOL FrameRect(

HDC hdc, //设备环境句柄

const RECT *lprc, //指向RECT结构的指针，用于指定要绘制边框的矩形区域

HBRUSH hbr //画刷句柄（Brush Handle），用于指定绘制边框的颜色或图案

);

FrameRect函数返回一个BOOL值，表示绘制成功与否。如果绘制成功，返回值为非零；如果失败，返回值为零。

FrameRect函数使用指定的画刷（可以是单色画刷或带图案的画刷）来绘制矩形的边框。边框的粗细和样式可以通过选择不同的画刷对象来实现。

需要注意的是，FrameRect函数绘制的边框不包括矩形区域本身，只会绘制边框线条。如果需要同时填充矩形区域的内部，请使用其他函数，如FillRect函数。

例如，下面的代码片段演示了如何使用FrameRect函数绘制一个红色的边框：

RECT rect = { 100, 100, 200, 200 }; // 定义要绘制边框的矩形区域

HBRUSH hbr = CreateSolidBrush(RGB(255, 0, 0)); // 创建一个红色画刷

FrameRect(hdc, &rect, hbr); // 绘制红色边框

DeleteObject(hbr); // 删除

■InvertRect函数

InvertRect函数用于在指定的设备上下文（Device Context）中反转（翻转）一个矩形区域的颜色。InvertRect函数的函数原型如下：

BOOL InvertRect(

HDC hDC, //指向目标设备上下文的句柄

const RECT *lprc //指向RECT结构的指针，指定要反转颜色的矩形区域

);

函数返回一个布尔值，表示是否成功反转矩形区域的颜色。

以下是使用InvertRect函数的示例代码：

HDC hdc = GetDC(hwnd); // 获取窗口的设备上下文

RECT rect;

SetRect(&rect, 100, 100, 200, 200); // 设置矩形的坐标

InvertRect(hdc, &rect); // 反转矩形区域的颜色

ReleaseDC(hwnd, hdc); // 释放设备上下文

上述代码中，通过调用GetDC函数获取窗口的设备上下文，并定义一个RECT结构rect。然后，使用SetRect函数设置矩形的坐标。接下来，通过调用InvertRect函数将矩形区域的颜色进行反转，即将原来的颜色取反。最后，通过调用ReleaseDC函数释放设备上下文。

InvertRect函数对于在设备上下文中反转矩形区域的颜色非常有用，可以用于创建反色效果、闪烁效果等视觉效果。

■SetRect函数

SetRect函数是Windows API中的一个函数，用于设置一个RECT结构的坐标。SetRect函数的函数原型如下：

void SetRect(

LPRECT lprc, //指向RECT结构的指针，用于接收设置后的坐标信息

int left, //指定矩形的左上角和右下角的坐标

int top,

int right,

int bottom

);

以下是使用SetRect函数的示例代码：

RECT rect;

SetRect(&rect, 100, 100, 200, 200); // 设置矩形的坐标

SetRect函数用于设置RECT结构的坐标，方便地定义一个矩形区域的位置和大小。

■OffsetRect函数

OffsetRect函数用于将一个RECT结构的坐标进行偏移或移动。OffsetRect函数的函数原型如下：

BOOL OffsetRect(

LPRECT lprc, //指向RECT结构的指针，指定要进行偏移或移动的矩形

int dx, // dx和dy分别表示在x轴和y轴上的偏移量

int dy

);

函数返回一个布尔值，表示是否成功进行矩形的偏移或移动。

以下是使用OffsetRect函数的示例代码：

RECT rect;

int dx = 10;

int dy = 20;

SetRect(&rect, 100, 100, 200, 200); // 设置矩形的坐标

OffsetRect(&rect, dx, dy); // 对矩形进行偏移或移动

// 偏移后的矩形坐标

int newLeft = rect.left;

int newTop = rect.top;

int newRight = rect.right;

int newBottom = rect.bottom;

上述代码中，定义了一个RECT结构rect，并定义了偏移量dx和dy。然后，通过调用SetRect函数将矩形的坐标设置为左上角(100, 100)、右下角(200, 200)。接下来，通过调用OffsetRect函数对矩形进行偏移或移动，将矩形的坐标在x轴上向右偏移10个单位，在y轴上向下偏移20个单位。最后，可以通过读取偏移后的矩形坐标，即rect的左上角和右下角的坐标，来获取偏移后的矩形位置。

OffsetRect函数对于在RECT结构中对矩形进行偏移或移动非常有用，可以用于调整矩形的位置、进行布局等操作。

■InflateRect函数

InflateRect函数用于在原有的RECT结构基础上扩大或缩小矩形的尺寸。InflateRect函数的函数原型如下：

BOOL InflateRect(

LPRECT lprc, //指向RECT结构的指针，指定要进行尺寸调整的矩形

int dx, // dx和dy分别表示在x轴和y轴方向上的扩展或收缩量

int dy

);

函数返回一个布尔值，表示是否成功进行矩形的尺寸调整。

以下是使用InflateRect函数的示例代码：

RECT rect;

int dx = 10;

int dy = 20;

SetRect(&rect, 100, 100, 200, 200); // 设置矩形的坐标

InflateRect(&rect, dx, dy); // 扩大或缩小矩形的尺寸

// 调整后的矩形坐标

int newLeft = rect.left;

int newTop = rect.top;

int newRight = rect.right;

int newBottom = rect.bottom;

上述代码中，定义了一个RECT结构rect，并定义了扩展或缩小量dx和dy。然后，通过调用SetRect函数将矩形的坐标设置为左上角(100, 100)、右下角(200, 200)。接下来，通过调用InflateRect函数对矩形的尺寸进行调整，将矩形的宽度在x轴上增加10个单位，在y轴上增加20个单位。最后，可以通过读取调整后的矩形坐标，即rect的左上角和右下角的坐标，来获取调整后的矩形尺寸。

InflateRect函数对于在RECT结构中调整矩形的尺寸非常有用，可以用于动态改变矩形的大小、进行裁剪等操作。

■SetRectEmpty函数

SetRectEmpty函数是Windows API中的一个函数，用于将一个RECT结构设置为空矩形。

SetRectEmpty函数的函数原型如下：

BOOL SetRectEmpty(

LPRECT lprc //指向RECT结构的指针，指定要设置为空矩形的RECT

);

函数返回一个布尔值，表示是否成功将RECT设置为空矩形。

以下是使用SetRectEmpty函数的示例代码：

RECT rect;

SetRectEmpty(&rect); // 设置rect为空矩形

上述代码中，定义了一个RECT结构rect。然后，通过调用SetRectEmpty函数将rect设置为空矩形。

空矩形是一个宽度和高度都为0的矩形，即左上角坐标和右下角坐标相等。

SetRectEmpty函数对于将RECT结构设置为空矩形非常有用，可以用于初始化矩形或在需要时将矩形重置为空矩形。

■CopyRect函数

CopyRect函数用于将一个RECT结构的坐标复制到另一个RECT结构。

CopyRect函数的函数原型如下：

BOOL CopyRect(

LPRECT lprcDst, //指向目标RECT结构的指针，用于接收源RECT结构的坐标

const RECT *lprcSrc //指向源RECT结构的指针，指定要复制坐标的源RECT结构

);

函数返回一个布尔值，表示是否成功将源RECT结构的坐标复制到目标RECT结构。

以下是使用CopyRect函数的示例代码：

RECT rectSrc;

RECT rectDst;

SetRect(&rectSrc, 100, 100, 200, 200); // 设置源矩形的坐标

CopyRect(&rectDst, &rectSrc); // 复制源矩形的坐标到目标矩形

// 目标矩形坐标

int dstLeft = rectDst.left;

int dstTop = rectDst.top;

int dstRight = rectDst.right;

int dstBottom = rectDst.bottom;

上述代码中，定义了两个RECT结构rectSrc和rectDst。然后，通过调用SetRect函数将源矩形的坐标设置为左上角(100, 100)、右下角(200, 200)。接下来，通过调用CopyRect函数将源矩形的坐标复制到目标矩形rectDst。最后，可以通过读取目标矩形坐标，即rectDst的左上角和右下角的坐标，来获取复制后的矩形位置。

CopyRect函数对于在不同的RECT结构之间复制矩形的坐标非常有用，可以用于复制、传递矩形的位置信息。

大多数情况下，还有一些简单的代码可以实现与这些函数相同的功能。例如，复制结构时，可以通过逐个字段的结构复制操作，来代替调用CopyRect函数，如下面的语句：

DestRect = SrcRect ;

■IntersectRect函数

IntersectRect函数用于计算两个矩形的交集，即它们重叠的部分。IntersectRect函数的函数原型如下：

BOOL IntersectRect(

LPRECT lprcDst, //指向目标RECT结构的指针，用于接收两个源RECT结构的交集

const RECT *lprcSrc1,//指向源RECT结构的指针1

const RECT *lprcSrc2//指向源RECT结构的指针2

);

函数返回一个布尔值，表示是否成功计算出两个矩形的交集。

以下是使用IntersectRect函数的示例代码：

RECT rect1;

RECT rect2;

RECT rectIntersect;

SetRect(&rect1, 100, 100, 200, 200); // 设置矩形1的坐标

SetRect(&rect2, 150, 150, 250, 250); // 设置矩形2的坐标

BOOL result = IntersectRect(&rectIntersect, &rect1, &rect2); // 计算两个矩形的交集

if (result)

{

// 交集矩形坐标

int intersectLeft = rectIntersect.left;

int intersectTop = rectIntersect.top;

int intersectRight = rectIntersect.right;

int intersectBottom = rectIntersect.bottom;

}

上述代码中，定义了两个RECT结构rect1和rect2，并定义了一个用于接收交集的RECT结构rectIntersect。然后，通过调用SetRect函数分别设置矩形1和矩形2的坐标。接下来，通过调用IntersectRect函数计算矩形1和矩形2的交集，并将结果存储在rectIntersect中。最后，可以通过读取交集矩形的坐标，即rectIntersect的左上角和右下角的坐标，来获取两个矩形的交集位置。

IntersectRect函数对于计算两个矩形的交集非常有用，可以用于碰撞检测、裁剪等应用场景。

■UnionRect函数

UnionRect函数是Windows API中的一个函数，用于计算两个矩形的并集，即包含这两个矩形的最小矩形。UnionRect函数的函数原型如下：

BOOL UnionRect(

LPRECT lprcDst, //指向目标RECT结构的指针，用于接收两个源RECT结构的并集

const RECT *lprcSrc1,//指向源RECT结构的指针1

const RECT *lprcSrc2//指向源RECT结构的指针2

);

函数返回一个布尔值，表示是否成功计算出两个矩形的并集。

以下是使用UnionRect函数的示例代码：

RECT rect1;

RECT rect2;

RECT rectUnion;

SetRect(&rect1, 100, 100, 200, 200); // 设置矩形1的坐标

SetRect(&rect2, 150, 150, 250, 250); // 设置矩形2的坐标

BOOL result = UnionRect(&rectUnion, &rect1, &rect2); // 计算两个矩形的并集

if (result)

{

// 并集矩形坐标

int unionLeft = rectUnion.left;

int unionTop = rectUnion.top;

int unionRight = rectUnion.right;

int unionBottom = rectUnion.bottom;

}

上述代码中，定义了两个RECT结构rect1和rect2，并定义了一个用于接收并集的RECT结构rectUnion。然后，通过调用SetRect函数分别设置矩形1和矩形2的坐标。接下来，通过调用UnionRect函数计算矩形1和矩形2的并集，并将结果存储在rectUnion中。最后，可以通过读取并集矩形的坐标，即rectUnion的左上角和右下角的坐标，来获取两个矩形的并集位置。

UnionRect函数对于计算两个矩形的并集非常有用，可以用于合并矩形、计算包围框等应用场景。

■IsRectEmpty函数

IsRectEmpty函数是Windows API中的一个函数，用于检查一个RECT结构是否为空矩形。IsRectEmpty函数的函数原型如下：

BOOL IsRectEmpty(

const RECT *lprc //指向要检查的RECT结构的指针

);

函数返回一个布尔值，表示指定的RECT结构是否为空矩形。如果RECT结构的宽度和高度都为0，则被认为是空矩形，函数返回TRUE；否则，函数返回FALSE。

以下是使用IsRectEmpty函数的示例代码：

RECT rect1;

RECT rect2;

SetRect(&rect1, 100, 100, 200, 200); // 设置矩形1的坐标

SetRectEmpty(&rect2); // 设置矩形2为空矩形

BOOL isEmpty1 = IsRectEmpty(&rect1); // 检查矩形1是否为空矩形

BOOL isEmpty2 = IsRectEmpty(&rect2); // 检查矩形2是否为空矩形

上述代码中，定义了两个RECT结构rect1和rect2。通过调用SetRect函数设置了矩形1的坐标，使其不为空矩形。而通过调用SetRectEmpty函数设置了矩形2为空矩形。接下来，通过调用IsRectEmpty函数分别检查矩形1和矩形2是否为空矩形，返回的布尔值isEmpty1和isEmpty2表示检查结果。

IsRectEmpty函数对于判断一个RECT结构是否为空矩形非常有用，可以用于条件判断、验证矩形是否有效等应用场景。

■PtInRect函数

PtInRect函数是Windows API中的一个函数，用于判断一个点是否在一个矩形内部。

PtInRect函数的函数原型如下：

BOOL PtInRect(

const RECT *lprc, //指向要检查的RECT结构的指针，表示要进行判断的矩形

POINT pt //是一个POINT结构，表示要检查的点的坐标

);

函数返回一个布尔值，表示指定的点是否在矩形内部。如果点在矩形内部，则返回TRUE；否则，返回FALSE。

以下是使用PtInRect函数的示例代码：

RECT rect;

POINT point;

SetRect(&rect, 100, 100, 200, 200); // 设置矩形的坐标

point.x = 150; // 设置要检查的点的X坐标

point.y = 150; // 设置要检查的点的Y坐标

BOOL isPointInRect = PtInRect(&rect, point); // 判断点是否在矩形内部

上述代码中，定义了一个RECT结构rect，并使用SetRect函数设置了矩形的坐标。然后，定义了一个POINT结构point，并设置了要检查的点的坐标。接下来，通过调用PtInRect函数判断点point是否在矩形rect内部，返回的布尔值isPointInRect表示判断结果。

PtInRect函数对于判断一个点是否在一个矩形内部非常有用，可以用于鼠标事件处理、碰撞检测等应用场景。

4.6.2 第28练：绘制随机矩形

/*------------------------------------------------------------------

028 WIN32 API 每日一练

第28个例子RANDRECT.C：绘制随机矩形

PeekMessage函数

SetRect函数

CreateSolidBrush函数

FillRect函数

----------------------------------------------------------------*/

#include <windows.h>

#include <stdlib.h>

//int cxClient,cyClient;

void DrawRectangle(HWND hwnd);

LRESULT CALLBACK WndProc (HWND, UINT, WPARAM, LPARAM) ;

int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,

PSTR szCmdLine, int iCmdShow)

{

//static int cxClient, cyClient;//不可以，改为全局变量

static TCHAR szAppName[] = TEXT ("RandRect.C") ;

…(略)

ShowWindow (hwnd, iCmdShow) ;

UpdateWindow (hwnd) ;

//消息循环

while (TRUE)

{

if (PeekMessage(&msg, NULL, 0, 0,PM_REMOVE))//消息队列不为空

{

if (msg.message == WM_QUIT)//如果是WM_QUIT消息退出循环

break;

TranslateMessage(&msg);

DispatchMessage(&msg);

}

else//消息队列为空

{

DrawRectangle(hwnd);//绘制随机矩形

}

return msg.wParam ;

}

//绘制随机矩形

void DrawRectangle(HWND hwnd)

{

HBRUSH hBrush;

HDC hdc;

RECT rect;

if (cxClient == 0 || cyClient == 0)

return;

SetRect(&rect,rand() %cxClient,rand()% cyClient,rand() %cxClient,rand()% cyClient);

//生成画刷,取随机色

hBrush = CreateSolidBrush(RGB(rand()%256,rand()%256,rand()%256));

hdc = GetDC(hwnd);//获取设备环境句柄

FillRect(hdc,&rect,hBrush);//填充矩形

ReleaseDC(hwnd,hdc);//释放设备环境句柄

DeleteObject(hBrush);//删除画刷

}

//窗口过程

LRESULT CALLBACK WndProc (HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)

{

switch (message)

{

case WM_SIZE:

cxClient = LOWORD(lParam);

cyClient = HIWORD(lParam);

return 0 ;

case WM_DESTROY:

PostQuitMessage(0);

return 0;

}

return DefWindowProc(hwnd, message, wParam, lParam);

}

/******************************************************************************

PeekMessage函数:调度传入的已发送消息，检查线程消息队列中是否有已发布消息，并检索消息（如果存在）。

BOOL PeekMessageA(

LPMSG lpMsg, //指向接收消息信息的MSG结构的指针

HWND hWnd, //要获取其消息的窗口的句柄。该窗口必须属于当前线程

UINT wMsgFilterMin, //在要检查的消息范围内的第一条消息的值

UINT wMsgFilterMax, //在要检查的消息范围内的最后一条消息的值

UINT wRemoveMsg //指定如何处理消息。此参数可以是以下一个或多个值

//PM_REMOVE允许一个程序检查程序队列中的下一个消息，而不是真实地获得并删除它看到的消息。

);

*******************************************************************************

SetRect函数:设置指定矩形的坐标。这等效于将left，top，right和bottom参数分配给RECT结构的适当成员。

BOOL SetRect(

LPRECT lprc, //指向包含要设置的矩形的RECT结构的指针

int xLeft,

int yTop,

int xRight,

int yBottom

);

*******************************************************************************

FillRect函数:通过使用指定的刷子填充的矩形。此功能包括左侧和顶部边框，但不包括矩形的右侧和底部边框

int FillRect(

HDC hDC,

const RECT *lprc, //指向RECT结构的指针，该结构包含要填充的矩形的逻辑坐标。

HBRUSH hbr //画刷句柄

);

*******************************************************************************

CreateSolidBrush函数：创建具有指定的纯色的逻辑刷

HBRUSH CreateSolidBrush(

COLORREF color //要创建COLORREF颜色值，请使用RGB宏

);

运行结果：

图4-16 绘制随机矩形

总结

1．上述实例的核心是PeekMessage函数，Peek是窥探的意思，该函数用于从消息队列中检索并移除一个消息（如果存在）。函数返回一个布尔值，表示是否成功检索到消息。如果存在消息并成功检索到，返回TRUE；否则，返回FALSE。

我们将消息循环中的GetMessage函数替换为PeekMessage函数，如果窥探到消息队列中有消息，且不是WM_QUIT消息则翻译和转发消息，是WM_QUIT消息则退出消息循环。如果消息队列中没有消息，则绘制随机矩形。

GetMessage与PeekMesssage的区别：

	GetMessage	PeekMessage
作用	获取一条消息，并从消息队列里删掉除该消息（除WM_PAINT外）。	检查消息队列的消息，是否删除，取决于最后一个参数是PM_REMOVE或PM_NOREMOVE。
控制权	获得消息，才返回。	立即返回，不管是否有消息
返回值	获得非WM_QUIT消息时，返回非零获得WM_QUIT时，返回0	TRUE表示有消息，FALSE表示没有消息。

2．随机矩形的绘制方法：

调用SetRect函数设置随机大小的矩形；

调用CreateSolidBrus函数生成随机颜色的画刷；

调用GetDC获取设备环境句柄；

调用FillRect函数填充随机矩形；

最后调用ReleaseDC函数是释放设备环境句柄，调用DeleteObject函数删除创建的GDI对象画刷。

3．动手实验：假如将变量int cxClient, cyClient设置为static变量，将无法通过编译。需要将其定义为全局变量。

4.6.3 矩形与区域的裁剪

在前面的章节中我们已经介绍了GDI对象：画笔、画刷。本小节将介绍另外一个GDI对象：区域。

区域在剪裁中也扮演着重要角色。InvalidRect函数使显示的矩形区域无效，并产生一个WM_PAINT消息。例如，可以使用InvalidateRect函数来擦除客户区的内容，并产生一个WM_PAINT消息：

InvalidateRect (hwnd, NULL, TRUE);

■无效区域和有效区域

可以通过调用GetUpdateRect函数获取无效矩形的坐标，并且使用ValidateRect函数使客户区的矩形有效。当接收到一个WM_PAINT消息时，PAINTSTRUCT结构中的无效矩形的坐标是可以利用的。这个结构是通过BeginPaint函数填充的。这个无效矩形也定义了一个 “剪裁区域”。不能在剪裁区域之外绘图。

●GetUpdateRect函数

GetUpdateRect函数用于获取指定窗口的更新区域的矩形坐标。GetUpdateRect函数的函数原型如下：

BOOL GetUpdateRect(

HWND hWnd, //指定窗口的句柄，表示要获取更新区域的窗口

LPRECT lpRect, //指向RECT结构的指针，用于接收获取到的更新区域的矩形坐标

BOOL bErase //一个布尔值，指定在绘制更新区域之前是否擦除背景

);

函数返回一个布尔值，表示是否成功获取到更新区域的矩形坐标。如果成功获取到，返回TRUE；否则，返回FALSE。

以下是使用GetUpdateRect函数的示例代码：

HWND hWnd = GetDesktopWindow(); // 获取桌面窗口的句柄

RECT rect;

// 获取更新区域的矩形坐标，不擦除背景

BOOL result = GetUpdateRect(hWnd, &rect, FALSE);

if (result)

{

// 成功获取到更新区域的矩形坐标

// 可以在矩形区域内进行绘制操作

}

上述代码中，通过调用GetDesktopWindow函数获取桌面窗口的句柄hWnd。然后，定义了一个RECT结构rect，用于接收更新区域的矩形坐标。接下来，通过调用GetUpdateRect函数获取桌面窗口的更新区域的矩形坐标，参数bErase设置为FALSE，表示不擦除背景。如果成功获取到更新区域的矩形坐标，可以在矩形区域内进行绘制操作。

GetUpdateRect函数通常在处理窗口的绘制操作时使用，用于获取需要进行更新绘制的区域。

●ValidateRect函数

ValidateRect函数用于使指定窗口的一个矩形区域无效，从而导致系统重新绘制该区域。

ValidateRect函数的函数原型如下：

BOOL ValidateRect(

HWND hWnd,//指定窗口的句柄，表示要使其矩形区域无效的窗口

const RECT *lpRect //指向RECT结构的指针，指定要使无效的矩形区域的坐标

);

函数返回一个布尔值，表示是否成功使矩形区域无效。如果成功，返回TRUE；否则，返回FALSE。

以下是使用ValidateRect函数的示例代码：

HWND hWnd = GetDesktopWindow(); // 获取桌面窗口的句柄

RECT rect;

// 设置要使无效的矩形区域坐标

rect.left = 100;

rect.top = 100;

rect.right = 200;

rect.bottom = 200;

BOOL result = ValidateRect(hWnd, &rect); // 使指定矩形区域无效

if (result)

{

// 成功使矩形区域无效

// 系统会重新绘制该区域

}

上述代码中，通过调用GetDesktopWindow函数获取桌面窗口的句柄hWnd。然后，定义了一个RECT结构rect，用于指定要使无效的矩形区域的坐标。接下来，通过调用ValidateRect函数使桌面窗口的指定矩形区域无效。如果成功使矩形区域无效，系统会重新绘制该区域。

ValidateRect函数通常在窗口的绘制操作中使用，用于标记特定的区域需要重新绘制。

Windows有两个类似InvalidateRect和ValidateRect的函数，用于处理区域而不是矩形：

●InvalddateRgn函数

InvalidateRgn函数用于使指定窗口的一个区域无效，从而导致系统重新绘制该区域。

InvalidateRgn函数的函数原型如下：

BOOL InvalidateRgn(

HWND hWnd, //指定窗口的句柄，表示要使其区域无效的窗口

HRGN hRgn, //指向区域的句柄，用于指定要使无效的区域

BOOL bErase //布尔值，用于确定在窗口重新绘制之前是否擦除无效区域的背景

);

函数返回一个布尔值，表示是否成功使区域无效。如果成功，返回TRUE；否则，返回FALSE。

以下是使用InvalidateRgn函数的示例代码：

HWND hWnd = GetDesktopWindow(); // 获取桌面窗口的句柄

HRGN hRgn = CreateRectRgn(100, 100, 200, 200); // 创建一个矩形区域

BOOL result = InvalidateRgn(hWnd, hRgn, FALSE); // 使指定区域无效

if (result)

{

// 成功使区域无效

// 系统会重新绘制该区域

}

DeleteObject(hRgn); // 删除区域对象

在上述代码中，通过调用GetDesktopWindow函数获取桌面窗口的句柄hWnd。然后，使用CreateRectRgn函数创建一个具有指定坐标的矩形区域的句柄hRgn。接下来，通过调用InvalidateRgn函数使桌面窗口的指定区域无效。如果成功使区域无效，系统会重新绘制该区域。最后，使用DeleteObject函数删除区域对象。

InvalidateRgn函数通常在窗口的绘制操作中使用，用于请求窗口在其内容发生变化或需要更新时重新绘制。

●ValidateRgn函数

ValidateRgn函数用于验证指定窗口的一个区域，标记该区域为有效，使系统不再重新绘制该区域。ValidateRgn函数的函数原型如下：

BOOL ValidateRgn(

HWND hWnd, //指定窗口的句柄，表示要验证的窗口

HRGN hRgn //指向区域的句柄，用于指定要验证的区域

);

函数返回一个布尔值，表示是否成功验证区域。如果成功，返回TRUE；否则，返回FALSE。

以下是使用ValidateRgn函数的示例代码：

HWND hWnd = GetDesktopWindow(); // 获取桌面窗口的句柄

HRGN hRgn = CreateRectRgn(100, 100, 200, 200); // 创建一个矩形区域

BOOL result = ValidateRgn(hWnd, hRgn); // 验证指定区域

if (result)

{

// 成功验证区域

// 该区域将被标记为有效，系统不再重新绘制该区域

}

DeleteObject(hRgn); // 删除区域对象

在上述代码中，通过调用GetDesktopWindow函数获取桌面窗口的句柄hWnd。然后，使用CreateRectRgn函数创建一个具有指定坐标的矩形区域的句柄hRgn。接下来，通过调用ValidateRgn函数验证指定的区域。如果成功验证区域，该区域将被标记为有效，系统不再重新绘制该区域。最后，使用DeleteObject函数删除区域对象。

ValidateRgn函数通常在窗口的绘制操作中使用，用于标记特定的区域为有效，告诉系统不再重新绘制该区域。

■选入裁剪区域

当接收一条由无效区域产生的WM_PAINT消息时，剪裁区域在形状上不一定是矩形。

可以通过将一个区域选入到设备环境来创建你自己的剪裁区域，将区域选入设备环境。可以使用SelectObject (hdc, hRgn)；或SelectClipRgn (hdc, hRgn)；

●SelectClipRgn函数

SelectClipRgn函数用于设置设备上下文（DC）的剪辑区域，限制绘图操作只在指定的区域内有效。SelectClipRgn函数的函数原型如下：

int SelectClipRgn(

HDC hdc, //要设置剪辑区域的设备上下文句柄

HRGN hrgn //设置的剪辑区域句柄

);

函数返回一个整数值，表示设置剪辑区域的结果。如果函数调用成功，则返回值为COMPLEXREGION、SIMPLEREGION或NULLREGION，分别表示剪辑区域的类型。如果函数调用失败，则返回ERROR。

以下是使用SelectClipRgn函数的示例代码：

HWND hWnd = GetDesktopWindow(); // 获取桌面窗口的句柄

HDC hdc = GetDC(hWnd); // 获取桌面窗口的设备上下文

HRGN hRgn = CreateRectRgn(100, 100, 200, 200); // 创建一个矩形剪辑区域

int result = SelectClipRgn(hdc, hRgn); // 设置剪辑区域

if (result != ERROR)

{

// 设置剪辑区域成功

// 绘图操作将受到剪辑区域的限制

}

DeleteObject(hRgn); // 删除剪辑区域对象

ReleaseDC(hWnd, hdc); // 释放设备上下文

在上述代码中，通过调用GetDesktopWindow函数获取桌面窗口的句柄hWnd。然后，通过调用GetDC函数获取桌面窗口的设备上下文hdc。接下来，使用CreateRectRgn函数创建一个具有指定坐标的矩形剪辑区域的句柄hRgn。然后，通过调用SelectClipRgn函数将剪辑区域设置到设备上下文中。如果成功设置剪辑区域，则绘图操作将受到剪辑区域的限制。最后，使用DeleteObject函数删除剪辑区域对象，并通过ReleaseDC函数释放设备上下文。

SelectClipRgn函数通常在绘图操作中使用，用于限制绘图操作的有效区域。

■创建区域

●创建矩形区域

CreateRectRgn 函数用于创建一个矩形区域（Region）对象。矩形区域定义为左上角坐标 (nLeftRect, nTopRect) 和右下角坐标 (nRightRect, nBottomRect) 所围成的矩形。

函数原型如下：

HRGN CreateRectRgn(

int nLeftRect, // 矩形左上角的 x 坐标

int nTopRect, // 矩形左上角的 y 坐标

int nRightRect, // 矩形右下角的 x 坐标

int nBottomRect // 矩形右下角的 y 坐标

);

返回值：

如果函数成功，返回一个表示矩形区域的句柄（HRGN）。

如果函数失败，返回值为 NULL。

●创建椭圆区域

CreateEllipticRgn 函数用于创建一个由给定椭圆外接矩形定义的椭圆区域对象。

HRGN CreateEllipticRgn(

int nLeftRect, // 椭圆外接矩形左上角的 x 坐标

int nTopRect, // 椭圆外接矩形左上角的 y 坐标

int nRightRect, // 椭圆外接矩形右下角的 x 坐标

int nBottomRect // 椭圆外接矩形右下角的 y 坐标

);

返回值：

如果函数成功，返回一个表示椭圆区域的句柄（HRGN）。

如果函数失败，返回值为 NULL。

●创建多边形区域

CreatePolygonRgn 函数用于创建一个由给定顶点坐标定义的多边形区域对象。

HRGN CreatePolygonRgn(

const POINT *lpPoints, // 指向一个 POINT 结构数组，包含多边形的顶点坐标

int nCount, // 多边形顶点的数量

int fnPolyFillMode // 多边形的填充模式，可以是 ALTERNATE 或 WINDING

);

返回值：

如果函数成功，返回一个表示多边形区域的句柄（HRGN）。

如果函数失败，返回值为 NULL。

■操作裁剪区域

GDI为剪裁区域做了一个副本，因此当把区域对象选入到设备环境后，可以删除它。 Windows还包括几个操纵这个剪裁区域的函数，例如ExcludeClipRect函数用来从剪裁区域中去除一个矩形；IntersectClipRect函数用来建立一个新的剪裁区域，这个新的剪裁区域是先前的剪裁区域和某个矩形的交集。OffsetClipRgn函数用来把一个剪裁区域移动到客户区的另外一部分。

●CombineRgn函数

CombineRgn 函数用于根据给定的组合模式，将两个区域进行组合操作，将结果存储在目标区域中。hDestRgn在初始时可以是一个很小的矩形区域。将两个源区域组合起来，并产生目标句柄，hDestRgn先前的区域将被销毁。

int CombineRgn(

HRGN hrgnDest, // 目标区域句柄，表示结果将存储在其中

HRGN hrgnSrc1, // 第一个源区域句柄

HRGN hrgnSrc2, // 第二个源区域句柄

int fnCombineMode // 区域的组合模式，可以是 RGN_AND、RGN_OR、RGN_XOR、RGN_DIFF、RGN_COPY

);

fnCombineMode：区域的组合模式，可以是以下常量之一：

RGN_AND：计算 hrgnSrc1 和 hrgnSrc2 的交集。

RGN_OR：计算 hrgnSrc1 和 hrgnSrc2 的并集。

RGN_XOR：计算 hrgnSrc1 和 hrgnSrc2 的异或。

RGN_DIFF：计算 hrgnSrc1 减去 hrgnSrc2 的差集。

RGN_COPY：将 hrgnSrc1 的副本复制到 hrgnDest。

返回值：

如果函数成功，返回值表示操作的结果：

COMPLEXREGION：结果是一个复杂区域。

SIMPLEREGION：结果是一个简单区域。

NULLREGION：结果是一个空区域。

如果函数失败，返回值为错误代码。

●ExcludeClipRect函数

ExcludeClipRect函数是Windows API中的一个函数，用于在设备上下文（DC）中排除指定的矩形区域，将该区域从剪辑区域中移除。ExcludeClipRect函数的函数原型如下：

int ExcludeClipRect(

HDC hdc, //要操作的设备上下文句柄

int left, //要排除的矩形区域的左上角和右下角的坐标

int top, //

int right, //

int bottom //

);

函数返回一个整数值，表示排除操作的结果。如果函数调用成功，则返回值为SIMPLEREGION、COMPLEXREGION或NULLREGION，分别表示剪辑区域的类型。如果函数调用失败，则返回ERROR。

以下是使用ExcludeClipRect函数的示例代码：

HWND hWnd = GetDesktopWindow(); // 获取桌面窗口的句柄

HDC hdc = GetDC(hWnd); // 获取桌面窗口的设备上下文

int left = 100;

int top = 100;

int right = 200;

int bottom = 200;

int result = ExcludeClipRect(hdc, left, top, right, bottom); // 排除矩形区域

if (result != ERROR)

{

// 排除矩形区域成功

// 绘图操作将不会在该区域内绘制

}

ReleaseDC(hWnd, hdc); // 释放设备上下文

在上述代码中，通过调用GetDesktopWindow函数获取桌面窗口的句柄hWnd。然后，通过调用GetDC函数获取桌面窗口的设备上下文hdc。接下来，定义了要排除的矩形区域的坐标。然后，通过调用ExcludeClipRect函数将该矩形区域从设备上下文的剪辑区域中移除。如果成功排除矩形区域，则绘图操作将不会在该区域内绘制。最后，通过ReleaseDC函数释放设备上下文。

ExcludeClipRect函数通常在绘图操作中使用，用于将指定的矩形区域从剪辑区域中排除，使得该区域不受剪辑的影响。

●IntersectClipRect函数

IntersectClipRect函数用于在设备上下文（DC）中与指定的矩形区域求交集，将剪辑区域限制为该交集区域。IntersectClipRect函数的函数原型如下：

int IntersectClipRect(

HDC hdc, //要操作的设备上下文句柄

int left, //要排除的矩形区域的左上角和右下角的坐标

int top,

int right,

int bottom

);

函数返回一个整数值，表示求交集操作的结果。如果函数调用成功，则返回值为SIMPLEREGION、COMPLEXREGION或NULLREGION，分别表示剪辑区域的类型。如果函数调用失败，则返回ERROR。

以下是使用IntersectClipRect函数的示例代码：

HWND hWnd = GetDesktopWindow(); // 获取桌面窗口的句柄

HDC hdc = GetDC(hWnd); // 获取桌面窗口的设备上下文

int left = 100;

int top = 100;

int right = 200;

int bottom = 200;

int result = IntersectClipRect(hdc, left, top, right, bottom); // 与矩形区域求交集

if (result != ERROR)

{

// 与矩形区域求交集成功

// 剪辑区域将被限制为交集区域

}

ReleaseDC(hWnd, hdc); // 释放设备上下文

在上述代码中，通过调用GetDesktopWindow函数获取桌面窗口的句柄hWnd。然后，通过调用GetDC函数获取桌面窗口的设备上下文hdc。接下来，定义了要与剪辑区域求交集的矩形区域的坐标。然后，通过调用IntersectClipRect函数将设备上下文的剪辑区域限制为与该矩形区域的交集。如果成功求交集，则剪辑区域将被限制为交集区域。最后，通过ReleaseDC函数释放设备上下文。

IntersectClipRect函数通常在绘图操作中使用，用于将设备上下文的剪辑区域限制为与指定矩形区域的交集。

●OffsetClipRgn函数

OffsetClipRgn函数用于将设备上下文（DC）的剪辑区域沿指定的偏移量进行平移。

OffsetClipRgn函数的函数原型如下：

int OffsetClipRgn(

HDC hdc, //表示要操作的设备上下文句柄

int x, //表示横向偏移量

int y //表示纵向偏移量

);

函数返回一个整数值，表示平移操作的结果。如果函数调用成功，则返回值为非零值。如果函数调用失败，则返回值为零。

以下是使用OffsetClipRgn函数的示例代码：

HWND hWnd = GetDesktopWindow(); // 获取桌面窗口的句柄

HDC hdc = GetDC(hWnd); // 获取桌面窗口的设备上下文

HRGN hRgn = CreateRectRgn(100, 100, 200, 200); // 创建一个矩形剪辑区域

int x = 50;

int y = 50;

int result = OffsetClipRgn(hdc, x, y); // 平移剪辑区域

if (result != ERROR)

{

// 平移剪辑区域成功

}

DeleteObject(hRgn); // 删除剪辑区域对象

ReleaseDC(hWnd, hdc); // 释放设备上下文

在上述代码中，通过调用GetDesktopWindow函数获取桌面窗口的句柄hWnd。然后，通过调用GetDC函数获取桌面窗口的设备上下文hdc。接下来，使用CreateRectRgn函数创建一个具有指定坐标的矩形剪辑区域的句柄hRgn。然后，定义了要进行的平移偏移量x和y。通过调用OffsetClipRgn函数将剪辑区域沿指定偏移量进行平移。如果成功平移剪辑区域，则剪辑区域被移动到新的位置。最后，使用DeleteObject函数删除剪辑区域对象，并通过ReleaseDC函数释放设备上下文。

OffsetClipRgn函数通常在绘图操作中使用，用于将设备上下文的剪辑区域沿指定偏移量进行平移。

■区域绘图函数

FillRgn(hdc,hRgn,hBrush)	//与FillRect类似
FrameRgn(hdc,hRgn,hBrush,xFrame,yFrame)	//xFrame,yFrame表示区域周围的边框的逻辑宽度和高度
InvertRgn(hdc,hRgn);	//与InvertRect类似
PaintRgn(hdc,hRgn);	//用当前设备环境的画刷来填充区域

【注意】区域作为GDI对象，不用的时候需要删除：

DeleteObject(hRgn); //删除GDI对象。

4.6.4 第29练：区域裁剪

/*------------------------------------------------------------------

029 WIN32 API 每日一练

第29个例子CLOVER.C：区域裁剪

SetCursor函数

ShowCursor函数

CombineRgn函数

SetViewportOrgEx函数

SelectClipRgn函数

CreateEllipticRgn函数

CreateRectRgn函数

----------------------------------------------------------------*/

#include <windows.h>

#include <math.h>

#define TWO_PI (2.0 * 3.14159)

LRESULT CALLBACK WndProc (HWND, UINT, WPARAM, LPARAM) ;

int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,

PSTR szCmdLine, int iCmdShow)

{

static TCHAR szAppName[] = TEXT ("RandRect.C") ;

…(略)

return msg.wParam ;

}

//窗口过程

LRESULT CALLBACK WndProc (HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)

{

static HRGN hRgnClip;

static int cxClient,cyClient;

double fAngle,fRadius;//角度和半径

HCURSOR hCursor;

HDC hdc;

HRGN hRgntemp[6];

PAINTSTRUCT ps;

switch (message)

{

case WM_SIZE:

cxClient = LOWORD(lParam);

cyClient = HIWORD(lParam);

hCursor = SetCursor(LoadCursor(NULL,IDC_WAIT));//设置光标形状

ShowCursor(TRUE);//显示光标

if (hRgnClip)//如果裁剪区域已存在

DeleteObject(hRgnClip);

//创建4个椭圆形区域

hRgntemp[0] = CreateEllipticRgn(0,cyClient/3,cxClient/2,2*cyClient/3);

hRgntemp[1] =

CreateEllipticRgn(cxClient/2,cyClient/3,cxClient,2*cyClient/3);

hRgntemp[2] =

CreateEllipticRgn(cxClient/3,0,2*cxClient/3,cyClient/2);

hRgntemp[3] =

CreateEllipticRgn(cxClient/3,cyClient/2,2*cxClient/3,cyClient);

//创建3个空区域

hRgntemp[4] = CreateRectRgn(0,0,0,0);

hRgntemp[5] = CreateRectRgn(0,0,1,1);

hRgnClip = CreateRectRgn(0,0,1,1);

//合并0，1椭圆

CombineRgn(hRgntemp[4],hRgntemp[0],hRgntemp[1],RGN_OR);

//合并2，3椭圆

CombineRgn(hRgntemp[5], hRgntemp[2], hRgntemp[3], RGN_OR);

//最后一次合并

CombineRgn(hRgnClip, hRgntemp[4], hRgntemp[5], RGN_XOR);//共同区域之外

//删除6个临时区域

for (int i = 0;i < 6;i++)

{

DeleteObject(hRgntemp[i]);

}

SetCursor(hCursor);

ShowCursor(FALSE);//隐藏光标

return 0 ;

case WM_PAINT:

hdc = BeginPaint(hwnd,&ps);

//视口原点设置在客户区中心

SetViewportOrgEx(hdc,cxClient/2,cyClient/2,NULL);

SelectClipRgn(hdc,hRgnClip);//选入区域

//区域内画直线，共360条，每一度画一条

fRadius = _hypot(cxClient/2.0,cyClient/2.0);//计算斜边

for (fAngle = 0.0;fAngle < TWO_PI;fAngle+=TWO_PI/360)

{

MoveToEx(hdc,0,0,NULL);

LineTo(hdc,(int)(fRadius*cos(fAngle)+0.5),(int)(-fRadius*sin(fAngle)+0.5));

}

EndPaint(hwnd,&ps);

return 0;

case WM_DESTROY:

DeleteObject(hRgnClip);

PostQuitMessage(0);

return 0;

}

return DefWindowProc(hwnd, message, wParam, lParam);

}

/******************************************************************************

SetCursor函数：设置光标形状。

HCURSOR SetCursor(

HCURSOR hCursor //光标的句柄

);

******************************************************************************

ShowCursor函数：显示或隐藏光标。

int ShowCursor(

BOOL bShow //如果bShow为TRUE，则显示计数增加一。如果bShow为FALSE，则显示计数减一。

);

备注

Windows 8：调用GetCursorInfo确定光标的可见性。

此功能设置一个内部显示计数器，该计数器确定是否应显示光标。仅当显示计数大于或等于0时才显示光标。

如果安装了鼠标，则初始显示计数为0。如果未安装鼠标，则显示计数为–1。

******************************************************************************

CombineRgn函数：结合了两个区域，并将结果存储在第三区域中。根据指定的模式将两个区域组合在一起。

int CombineRgn(

HRGN hrgnDst,//组合后的新区域句柄

HRGN hrgnSrc1,//组合区域1

HRGN hrgnSrc2,//组合区域2

int iMode //组合方式

);

******************************************************************************

SetViewportOrgEx函数：指定哪些设备点映射到窗口原点（0,0）

BOOL SetViewportOrgEx(

HDC hdc,

int x,//新视口原点的X坐标（以设备为单位）

int y,//新视口原点的Y坐标（以设备为单位）

LPPOINT lppt//指向POINT结构的指针，该结构接收设备坐标中的先前视口原点，NULL不使用该参数

);

******************************************************************************

SelectClipRgn函数：选择的区域作为用于指定设备上下文的当前剪辑区域

int SelectClipRgn(

HDC hdc,

HRGN hrgn//要选择的区域的句柄

);

******************************************************************************

CreateEllipticRgn函数：创建一个椭圆区域

HRGN CreateEllipticRgn(

int x1, //以逻辑单位指定椭圆边界矩形左上角的 x 坐标

int y1,

int x2,

int y2

);

******************************************************************************

CreateRectRgn函数：创建一个矩形区域

HRGN CreateRectRgn(

int x1, //以逻辑单位指定区域左上角的 x 坐标

int y1,

int x2,

int y2

);

运行结果：

图4-17 区域裁剪

总结

上述实例的窗口过程在处理WM_SIZE消息时，先创建4个椭圆区域，接着创建3个空区域备用。然后调用CombineRgn函数分别合并椭圆0和1，椭圆2和3，存入空区域4和5。最后再次调用CombineRgn函数合并区域4和5，并删除6个临时区域，保留最后一个合并区域。

在处理WM_PAINT消息时，调用SetViewportOrgEx函数将视口原点设置在客户区中心，并调用SelectClipRgn函数选人区域句柄。最后调用数学函数_hypo在区域内画直线，共360条，每一度画一条。

【注意】遵守GDI对象三原则，退出程序前，在WM_DESTROY消息中调用DeleteObject函数删除区域句柄。