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