18. BeginPaint

BeginPaint

函数功能：

BeginPaint 函数为指定窗口进行绘画作准备，并用将和绘画有关的信息填充到一个 PAINTSTRUCT 结构中。

API 函数原型：

HDC BeginPaint(
  _In_   HWND hwnd,
  _Out_  LPPAINTSTRUCT lpPaint
);

参数解析：

参数	含义
hwnd	需要重新绘制的窗口句柄
IpPaint	指向PAINTSTRUCT结构的指针，用于存放绘画相关的信息

返回值：

1. 如果函数成功，返回值是指定窗口的“显示设备描述表”句柄；

2. 如果函数失败，返回值是 NULL，表明没有得到显示设备的内容。

备注：

1. BeginPaint 函数自动设置显示设备内容的剪切区域，而排除任何更新区域外的区域。该更新区域可以通过 InvalidateRect 或 InvalidateRgn 函数设置，也可以是系统在改变大小、移动、创建、滚动后设置的，或者其他的影响客户区的操作来设置的。

2. 如果更新区域被标记为可擦除的，BeginPaint 发送一个 WM_ERASEBKGND 消息给窗口。

3. 一个应用程序除了响应 WM_PAINT 消息外，不应该调用 BeginPaint。

4. 每次调用 BeginPaint 都应该有相应的 EndPaint 函数。

5. 如果被绘画的客户区中有一个 caret（caret：插入符。是窗口客户区中的一个闪烁的线，块，或位图。插入符通常表示文本或图形将被插入的地方。即一闪一闪的光标），BeginPaint 自动隐藏该符号，而保证它不被擦除。

6. 如果窗口类有一个背景刷，BeginPaint 使用这个刷子来擦除更新区域的背景。