GDI 设备环境句柄(2)

WM_PAINT 消息的触发

Windows 程序在以下情况会触发WM_PAINT消息:

  • 窗口被移动导致被遮盖部分暴露出来
  • 用户调整窗口的大小(当窗口类的 style 字段被设置为 CS_HREDRAW 和 CS_VREDRAW)
  • 调用 ScrollWindow 或 ScrollDC 函数滚动客户区
  • 调用 InvalidateRect 或 InvalidateRgn 函数生成 WM_PAINT

获取设备环境句柄

需要在屏幕上绘图的时候,需要先获取到设备环境句柄,这里有两种方式:

1、调用 BeginPaint 函数(用于响应 WM_PAINT 消息)

第一个参数是当前的窗口句柄,第二个参数是 PAINTSTRUCT 结构的地址,它将返回一个设备环境句柄。BeginPaint 函数的原型如下:

HDC BeginPaint(
  HWND hwnd,            // 当前的窗口句柄
  LPPAINTSTRUCT lpPaint // PAINTSTRUCT 结构的地址
)

Windows 为每个窗口维护一个“绘制信息结构”,即 PAINTSTRUCT,这里给出了它的定义:

typedef struct tagPAINTSTRUCT { 
  HDC  hdc;             // 设备环境句柄,即 BeginPaint 函数的返回值
  BOOL fErase;          // 背景刷状态,如果为 TRUE,表示无效背景区域需要进行擦除,为 FALSE,表示已经擦除了无效区域的背景
  RECT rcPaint;         // 无效矩形边界,是一个 RECT 结构,包含 left、top、right、bottom 四个参数
  BOOL fRestore; 
  BOOL fIncUpdate; 
  BYTE rgbReserved[]; 
} PAINTSTRUCT;

调用 BeginPaint 函数时,PAINTSTRUCT 结构中的字段将被自动填充。

当调用 BeginPaint 函数获得设备环境句柄,并处理 WM_PAINT 消息后,必须使用 EndPaint 函数释放获取到的设备环境句柄,该函数原型如下:

BOOL EndPaint(
  HWND hWnd,                  // 当前的窗口句柄
  CONST PAINTSTRUCT *lpPaint  // PAINTSTRUCT 结构的地址
);

源码片段示例:

// ......
case WM_PAINT:
    hdc = BeginPaint(hwnd, &ps);
    // 其他GDI代码
    EndPaint(hwnd, &ps);
    return ;
// ......

2、调用 GetDC 函数(用于响应非 WM_PAINT 消息)

GetDC 函数只有一个参数,即当前的窗口句柄,它将设备环境句柄作为返回值返回。在使用完设备环境句柄后,必须调用 ReleaseDC 函数将其释放,它有两个参数,第一个是当前的窗口句柄,第二个是要释放的设备环境句柄。

源码片段示例:

// ......
    hdc = GetDC(hwnd);
    // 其他GDI代码
    ReleaseDC(hwnd, hdc);
    return 0;
// ......

GetDC / ReleaseDC 组合通常用于处理键盘消息或(与)鼠标消息。

需要注意的地方(小结)

  • WM_PAINT 消息的产生,表示窗口客户区需要重绘。
  • BeginPaint 函数返回的是无效矩形客户区(PAINTSTRUCT 结构中的 rcPaint 字段)的设备环境句柄,而 GetDC 函数返回的是整个客户区的设备环境句柄。
  • BeginPaint 函数调用后,无效矩形区域将变得有效化;而 GetDC 函数本身不会使客户区无效区域有效化,需要自行调用 ValidateRect 函数使客户区无效区域有效化。

相关推荐