[学习笔记] Windows编程——GDI——（十五）矩形

前言：

学习笔记，随时更新。如有谬误，欢迎指正。

---

说明：

1. 红色字体为较为重要部分。
2. 绿色字体为个人理解部分。

---

原文链接：https://learn.microsoft.com/en-us/windows/win32/gdi/rectangles

15 矩形

1. 应用程序使用矩形来指定屏幕上或窗口中的矩形区域。

15.1 关于矩形

1. 矩形用于光标裁剪区域、客户区的无效部分、显示格式化文本的区域或滚动区域。应用程序还可以使用矩形填充、勾勒或反转客户区的一部分，并查询窗口或窗口的客户区的坐标。

15.1.1 矩形坐标

1. 应用程序必须使用 RECT 结构来定义矩形。该结构指定两点的坐标：矩形的左上角和右下角。矩形的边从这两点延伸，并平行于 x 轴和 y 轴。

2. 矩形的坐标值表示为带符号整数。矩形的右边的坐标值必须大于左边的坐标值。同样，底部的坐标值必须大于顶部的坐标值。

3. 由于应用程序可以将矩形用于许多不同的目的，因此矩形函数不使用显式的度量单位。相反，所有矩形坐标和尺寸都以带符号的逻辑值给出。映射方式和使用矩形的功能决定了度量单位。有关坐标和映射模式的详细信息，请参见坐标空间和转换。

15.1.2 矩形操作

1. SetRect 函数创建一个矩形。

2. CopyRect 函数复制一个给定矩形。

3. SetRectEmpty 函数创建一个空矩形。空矩形是宽度为零、高度为零或两者都为零的矩形。

4. IsRectEmpty 函数确定给定的矩形是否为空。

5. EqualRect 函数确定两个矩形是否相同，也就是说，它们是否具有相同的坐标。

6. InflateRect 函数的作用是增加或减少矩形的宽度或高度，或两者同时增加或减少。它可以从矩形的两端添加或删除宽度；它可以从矩形的顶部和底部添加或删除高度。

7. OffsetRect 函数的作用是：将一个矩形移动给定的量。

8. PtInRect 函数确定给定的点是否位于给定的矩形内。如果点位于矩形的左侧或顶部或完全在矩形内，则该点位于矩形内。如果点位于矩形的右侧或底部，则该点不在矩形内。

9. IntersectRect 函数创建一个新的矩形，它是两个现有矩形的交集。

10. UnionRect 函数创建一个新的矩形，它是两个现有矩形的并集。

15.2 使用矩形

1. 有关详细信息，请参阅使用矩形。

15.3 矩形参考

15.3.1 矩形函数

1. 有关详细信息，请参阅矩形函数。

15.3.2 矩形结构体

1. 有关详细信息，请参阅矩形结构体。

15.3.3 矩形宏

1. 有关详细信息，请参阅矩形宏。