为指定窗口进行绘图工作做准备
函数功能:
BeginPaint 函数为指定窗口进行绘画工作的准备,并用将和绘画有关的信息填充到一个 PAINTSTRUCT 结构中。
API 函数原型:
HDC BeginPaint\(
\_In\_ HWND hwnd,
\_Out\_ LPPAINTSTRUCT lpPaint
\);
参数解析:
| 参数 | 含义 |
|---|---|
| hwnd | 需要重新绘制的窗口句柄 |
| lpPaint | 指向 PAINTSTRUCT 结构的指针,用于存放绘画相关的信息 |
返回值:
- 如果函数成功,返回值是指定窗口的“显示设备描述表”句柄;
- 如果函数失败,返回值是 NULL,表明没有得到显示设备的内容。
备注:
- BeginPaint 函数自动设置显示设备内容的剪切区域,而排除任何更新区域外的区域。该更新区域可以通过 InvalidateRect 或 InvalidateRgn 函数设置,也可以是系统在改变大小、移动、创建、滚动后设置的,或者其他的影响客户区的操作来设置的。
- 如果更新区域被标记为可擦除的,BeginPaint 发送一个 WM_ERASEBKGND 消息给窗口。
- 一个应用程序除了响应 WM_PAINT 消息外,不应该调用 BeginPaint。
- 每次调用 BeginPaint 都应该有相应的 EndPaint 函数。
- 如果被绘画的客户区中有一个 caret(caret:插入符。是窗口客户区中的一个闪烁的线,块,或位图。插入符通常表示文本或图形将被插入的地方。即一闪一闪的光标),BeginPaint 自动隐藏该符号,而保证它不被擦除。
- 如果窗口类有一个背景刷,BeginPaint 使用这个刷子来擦除更新区域的背景。