• 1.摘要
  • 2.基本信息
  • 3.函数原型
  • 4.参数
  • 5.返回值
  • 6.备注
  • 7.例子代码

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使用这个刷子来擦除更新区域的背景。

例子代码