勇芳软件工作室.汉化:  Painting and Drawing > Painting and Drawing Functions >

BeginPaint

Previous pageReturn to chapter overviewNext page

描述

 

BeginPaint函数准备指定的绘画窗口,并填写PAINTSTRUCT结构,其中包含有关绘画的信息。

 

C++ 语法

 

HDC BeginPaint(

__in  HWND hwnd,

__out LPPAINTSTRUCT lpPaint

);

 

PowerBASIC 语法

 

FUNCTION BeginPaint ( _

BYVAL hwnd AS DWORD, _

BYREF lpPaint AS PAINTSTRUCT _

) AS DWORD

 

参数

 

hwnd

 

[in]处理窗口被重画。

 

lpPaint

 

[in]指向将接收绘画信息的PAINTSTRUCT结构的指针。

 

返回值

 

如果函数成功,则返回值是指定窗口的显示设备上下文的句柄。

 

如果函数失败,则返回值为NULL,表示没有显示设备上下文可用。

 

备注

 

BeginPaint功能自动设置设备上下文的剪切区域,以排除更新区域之外的任何区域。更新区域由InvalidateRectInvalidateRgn功能设置,并在系统调整,移动,创建,滚动或影响客户区域的任何其他操作之后进行设置。如果更新区域被标记为擦除,BeginPaint将向窗口发送WM_ERASEBKGND消息。

 

应用程序不应该调用BeginPaint,除了响应WM_PAINT消息。每次致电BeginPaint必须有一个对应的EndPaint功能。

 

如果插入符号在要绘画的区域中,BeginPaint将自动隐藏插入符,以防止它被擦除。

 

如果窗口的类有一个背景画刷,BeginPaint将使用该画笔擦除更新区域的背景,然后再返回。

 

引用文件 #INCLUDE Once

 

WinUser.inc(包括Windows.inc)