Windows API GDI(1) BeginPaint和EndPaint函数

BeginPaint和EndPaint函数

说明：
BeginPaint：函数为指定窗口进行绘图工作的准备，并用将和绘图有关的信息填充到PAINTSTRUCT结构中。
EndPaint：和BeginPaint成对出现，描画完成释放。

BeginPaint 函数的作用是告诉 Windows 系统，要开始向显示卡输出内容了，把这次显示的操作请求放到系统显示队列里。由于系统上的显示卡往往只有一个，那么这种资源是独占的，所以操作系统会让显示操作线性化，保证每个窗口的显示是独立进行的，而不是 A 窗口显示一部份，或者 B 窗口显示一部份，而是 A 窗口显示完成后再让 B 窗口显示。因此， BeginPaint 函数就是跟操作系统说，我需要显示了，你安排好吧。当 BeginPaint 返回时，就获取到系统的显示资源句柄，这样就可以调 GDI 一大堆函数来操作了。显示完成后，一定要记得调用函数 EndPaint ，因为使用 BeginPaint 函数请求了独占的显示资源后，如果不释放回去，就会让其它程序永远获取不到显示资源了，这样系统就死锁了。

函数声明：

HDC BeginPaint( 
	HWND hWnd, 
	LPPAINTSTRUCT lpPaint 
	);
	
BOOL EndPaint( 
	HWND hWnd, 
	const PAINTSTRUCT *lpPaint 
	);

参数：
hWnd ：[in]被重绘的窗口句柄。
lpPaint ：[out]指向一个用来接收绘画信息的PAINTSTRUCT结构，结构体定义如下：

	typedef struct tagPAINTSTRUCT {
	 HDC hdc;
	 BOOL fErase;
	 RECT rcPaint;
	 BOOL fRestore;
	 BOOL fIncUpdate;
	 BYTE rgbReserved[32];
	} PAINTSTRUCT, *PPAINTSTRUCT;
	
	【hdc】 是获取设备句柄。
	【fErase】 是否擦新背景。
	【rcPaint】 是显示的窗口大小。
	【fRestore 、 fIncUpdate 、 rgbReserved】 是保留使用的参数。

返回值：
　　如果函数成功，返回值是指定窗口的“显示设备描述表”句柄。
　　如果函数失败，返回值是NULL，表明没有得到显示设备的内容。
　　Windows NT/2000/XP: 使用GetLastError得到更多的错误信息。
　　
备注：
BeginPaint函数自动设置显示设备内容的剪切区域，而排除任何更新区域外的区域。该更新区域可以通过InvalidateRect或InvalidateRgn函数设置，也可以是系统在改变大小、移动、创建、滚动后设置的，亦是其他的影响客户区的操作来设置的。如果更新区域被标记为可擦除的，BeginPaint发送一个WM_ERASEBKGND消息给窗口。

一个应用程序除了响应WM_PAINT消息外，不应该调用BeginPaint。每次调用BeginPaint都应该有相应的EndPaint函数。

如果被绘画的客户区中有一个^符号，BeginPaint自动隐藏该符号，而保证它不被擦除。

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

例子代码：
1.　你使用BeginPaint和EndPaint函数来准备和完成客户区的绘画。BeginPaint返回一个用来绘画的客户区的显示设备内容的HANDLE，EndPaint终止绘画请求，并释放设备内容。
下面的例子中，窗口程序写HELLO WINDOWS消息到窗口的客户区。为了使字符串在窗口第一次创建的时候可见，WinMain函数在创建和显示窗口之后立即调用UpdateWindow，这导致一个WM_PAINT消息被立即发送到窗口程序中。

LRESULT APIENTRY WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)

　　{

　　PAINTSTRUCT ps;

　　HDC hdc;

　　switch (message)

　　{

　　case WM_PAINT:

　　hdc = BeginPaint(hwnd, &ps);

　　TextOut(hdc, 0, 0, "Hello, Windows!", 15);

　　EndPaint(hwnd, &ps);

　　return 0;

　　// Process other messages.

　　}

　　}

　　int APIENTRY WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)

　　{

　　HWND hwnd;

　　hwnd = CreateWindowEx(

　　// parameters

　　);

　　ShowWindow(hwnd, SW_SHOW);

　　UpdateWindow(hwnd);

　　return msg.wParam;

　　}

　　2.BeginPaint在GDI,GDI+中的具体代码示例

　　采用GDI绘图

　　HDC hdc;//设备场景DC

　　PAINTSTRUCT ps;

　　HEPN hPen;

　　HPEN hPenOld;

　　hdc = BeginPaint( hWnd , &ps );

　　hPen = CreatePen( PS_SOLID , 3 , RGB( 255 , 0 , 0 );

　　hPenOld = ( HPEN )SelectObject ( hdc , hPen );

　　MoveToEx ( hdc , 20 , 10 , NULL );

　　LineTo( hdc , 200 ,100);

　　SelectObject (hdc , hOldPen);

　　DeleteObject ( hPen );

　　EndPaint ( hWnd , &ps );]

　　采用GDI+绘图

　　HDC hdc ;

　　Graphics *myGraphics = new Graphics ( hdc );

　　Pen *myPen = new Pen (Color( 255 , 255 , 0 , 0) , 3 );

　　PANINTSTRUCT ps;

　　hdc = BeginPaint( hWnd , &ps );

　　myGraphics ->DrawLine ( myPen , 20 ,10 ,200 ,100);

　　delete myGraphics ;

　　delete myPen ;

　　EndPaint (hWnd , hdc);