本课中,我们将学习如何在窗口的客户区“绘制”字符串。我们还将学习关于“设备环境”的概念。
理论:
Windows 中的文本是一个GUI(图形用户界面)对象。每一个字符实际上是由许多的像素点组成,这些点在有笔画的地方显示出来,这样就会出现字符。这也是为什么我说“绘制”字符,而不是写字符。通常您都是在您应用程序的客户区“绘制”字符串(尽管您也可以在客户区外“绘制”)。Windows 下的“绘制”字符串方法和 Dos 下的截然不同,在 Dos 下,您可以把屏幕想象成 85 x 25 的一个平面,而 Windows 下由于屏幕上同时有几个应用程序的画面,所以您必须严格遵从规范。Windows 通过把每一个应用程序限制在他的客户区来做到这一点。当然客户区的大小是可变的,您随时可以调整。
在您在客户区“绘制”字符串前,您必须从 Windows 那里得到您客户区的大小,确实您无法像在 DOS 下那样随心所欲地在屏幕上任何地方“绘制”,绘制前您必须得到 Windows 的允许,然后 Windows 会告诉您客户区的大小,字体,颜色和其它 GUI 对象的属性。您可以用这些来在客户区“绘制”。
什么是“设备环境”(DC)呢? 它其实是由 Windows 内部维护的一个数据结构。一个“设备环境”和一个特定的设备相连。像打印机和显示器。对于显示器来说,“设备环境”和一个个特定的窗口相连。
“设备环境”中的有些属性和绘图有关,像:颜色,字体等。您可以随时改动那些缺省值,之所以保存缺省值是为了方便。您可以把“设备环境”想象成是Windows 为您准备的一个绘图环境,而您可以随时根据需要改变某些缺省属性。
当应用程序需要绘制时,您必须得到一个“设备环境”的句柄。通常有几种方法。
- 在 WM_PAINT 消息中使用 BeginPaint
- 在其他消息中使用 GetDC
- CreateDC 建立你自己的 DC
您必须牢记的是,在处理单个消息后你必须释放“设备环境”句柄。不要在一个消息处理中获得 “设备环境”句柄,而在另一个消息处理中在释放它。
我们在Windows 发送 WM_PAINT 消息时处理绘制客户区,Windows 不会保存客户区的内容,它用的是方法是“重绘”机制(譬如当客户区刚被另一个应用程序的客户区覆盖),Windows 会把 WM_PAINT 消息放入该应用程序的消息队列。重绘窗口的客户区是各个窗口自己的责任,您要做的是在窗口过程处理 WM_PAINT 的部分知道绘制什么和何如绘制。
您必须了解的另一个概念是“无效区域”。Windows 把一个最小的需要重绘的正方形区域叫做“无效区域”。当 Windows 发现了一个”无效区域“后,它就会向该应用程序发送一个 WM_PAINT 消息,在 WM_PAINT 的处理过程中,窗口首先得到一个有关绘图的结构体,里面包括无效区的坐标位置等。您可以通过调用BeginPaint 让“无效区”有效,如果您不处理 WM_PAINT 消息,至少要调用缺省的窗口处理函数 DefWindowProc ,或者调用 ValidateRect 让“无效区”有效。否则您的应用程序将会收到无穷无尽的 WM_PAINT 消息。
下面是响应该消息的步骤:
- 取得“设备环境”句柄
- 绘制客户区
- 释放“设备环境”句柄
注意,您无须显式地让“无效区”有效,这个动作由 BeginPaint 自动完成。您可以在 BeginPaint 和 Endpaint 之间,调用所有的绘制函数。几乎所有的GDI 函数都需要“设备环境”的句柄作为参数。
例子: (见光盘FirstWindow2)
下面我们将写一个应用程序,它会在客户区的中心显示一行 "Win32 program, Simple and powerful !"
1 #include "Windows.h" 2 #include "tchar.h" 3 4 HWND hWinMain; 5 TCHAR szClassName[] = _T("MyClass"); 6 TCHAR szCaptionMain[] = _T("My First Window!"); 7 TCHAR szText[] = _T("Win32 program, Simple and powerful !"); 8 WNDCLASSEX stdWndClass; 9 10 LRESULT CALLBACK ProcWinMain(HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam ) 11 { 12 PAINTSTRUCT stPs; 13 RECT stRect; 14 HDC hDC; 15 switch(Msg) 16 { 17 case WM_PAINT: 18 { 19 hDC = BeginPaint(hWnd,&stPs); 20 GetClientRect(hWnd,&stRect); 21 DrawText(hDC, szText,-1,&stRect,DT_SINGLELINE|DT_CENTER|DT_VCENTER); 22 EndPaint(hWnd,&stPs); 23 } 24 break; 25 case WM_CLOSE: 26 { 27 DestroyWindow(hWinMain); 28 PostQuitMessage(NULL); 29 } 30 break; 31 default: 32 return DefWindowProc(hWnd, Msg, wParam, lParam ); 33 } 34 return 0; 35 } 36 37 int WINAPI WinMain(HINSTANCE hInstance,HINSTANCE hPrevInstance,LPSTR lpCmdLine,int nCmdShow) 38 { 39 MSG stMsg; 40 WNDCLASSEX stdWndClass; 41 RtlZeroMemory(&stdWndClass, sizeof(stdWndClass)); 42 stdWndClass.hCursor = LoadCursor(0,IDC_ARROW); 43 stdWndClass.cbSize = sizeof(stdWndClass); 44 stdWndClass.style = CS_HREDRAW|CS_VREDRAW; 45 stdWndClass.lpfnWndProc = ProcWinMain; 46 stdWndClass.hbrBackground = (HBRUSH)COLOR_WINDOW; 47 stdWndClass.lpszClassName = szClassName; 48 stdWndClass.hInstance = hInstance; 49 50 RegisterClassEx(&stdWndClass); 51 52 hWinMain = CreateWindowEx(WS_EX_CLIENTEDGE,szClassName,szCaptionMain,53 WS_OVERLAPPEDWINDOW,100,100,600,400,NULL,NULL,hInstance,NULL); 54 55 if(!hWinMain) 56 return 0; 57 58 ShowWindow(hWinMain,SW_SHOWNORMAL); 59 UpdateWindow(hWinMain); 60 61 while(GetMessage(&stMsg,NULL,0,0)) 62 { 63 TranslateMessage(&stMsg); 64 DispatchMessage(&stMsg); 65 } 66 67 return stMsg.wParam; 68 }
分析:
这里的大多数代码和第三课中的一样。我只解释其中一些不相同的地方。
PAINTSTRUCT stPs; RECT stRect; HDC hDC;
这些局部变量由处理 WM_PAINT 消息中的 GDI 函数调用。hdc 用来存放调用 BeginPaint 返回的“设备环境”句柄。ps 是一个 PAINTSTRUCT 数据类型的变量。通常您不会用到其中的许多值,它由 Windows 传递给 BeginPaint,在结束绘制后再原封不动的传递给 EndPaint。rect 是一个 RECT 结构体类型参数,它的定义如下:
typedef struct tagRECT { LONG left; LONG top; LONG right; LONG bottom; }RECT;
left 和 top 是正方形左上角的坐标。right 和 bottom 是正方形右下角的坐标。客户区的左上角的坐标是 x=0,y=0,这样对于 x=0,y=10 的坐标点就在它的下面。
hDC = BeginPaint(hWnd,&stPs); GetClientRect(hWnd,&stRect); DrawText(hDC, szText,-1,&stRect,DT_SINGLELINE|DT_CENTER|DT_VCENTER); EndPaint(hWnd,&stPs);
在处理 WM_PAINT 消息时,您调用BeginPaint函数,传给它一个窗口句柄和未初始化的 PAINTSTRUCT 型参数。调用成功后在 hDC中得到返回“设备环境”的句柄。下一次,调用 GetClientRect 以得到客户区的大小,大小放在 rect 中,然后把它传给 DrawText。DrawText 的语法如下:
WINUSERAPI int WINAPI DrawTextA( HDC hDC, LPCSTR lpString, int nCount, LPRECT lpRect, UINT uFormat);
DrawText是一个高层的调用函数。它能自动处理像换行、把文本放到客户区中间等这些杂事。所以您只管集中精力“绘制”字符串就可以了。我们会在下一课中讲解低一层的函数 TextOut,该函数在一个正方形区域中格式化一个文本串。它用当前选择的字体、颜色和背景色。它处理换行以适应正方形区域。它会返回以设备逻辑单位度量的文本的高度,我们这里的度量单位是像素点。让我们来看一看该函数的参数:
- hdc: “设备环境”的句柄。
- lpString:要显示的文本串,该文本串要么以NULL结尾,要么在nCount中指出它的长短。
- nCount:要输出的文本的长度。若以NULL结尾,该参数必须是-1。
- lpRect: 指向要输出文本串的正方形区域的指针,该方形必须是一个裁剪区,也就是说超过该区域的字符将不能显示。
- uFormat:指定如何显示。我们可以用 or 把以下标志或到一块:
- DT_SINGLELINE:是否单行显示。
- DT_CENTER:是否水平居中。
- DT_VCENTER :是否垂直居中。
结束绘制后,必须调用 EndPaint 释放“设备环境”的句柄。 好了,现在我们把“绘制”文本串的要点总结如下:
- 必须在开始和结束处分别调用 BeginPaint 和 EndPaint;
- 在 BeginPaint 和 EndPaint 之间调用所有的绘制函数;
- 如果在其它的消息处理中重新绘制客户区,您可以有两种选择: (1)用GetDC和ReleaseDC代替BeginPaint和EndPaint; (2)调用InvalidateRect或UpdateWindow让客户区无效,这将迫使WINDOWS把WM_PAINT放入应用程序消息队列,从而使得客户区重绘。
windows sdk编程系列文章 ---- 学习更多关于“绘制”文本串的知识
我们将做更多的实践去了解有关文本的诸多属性如字体和颜色等。
理论:
Windows 的颜色系统是用RGB值来表示的,R 代表红色,G 代表绿色,B 代表兰色。如果您想指定一种颜色就必须给该颜色赋相关的 RGB 值,RGB 的取值范围都是从 0 到 255,譬如您想要得到纯红色,就必须对RGB赋值(255,0,0),纯白色是 (255,255,255)。从我们下面的例子中您可以看出来要想运用好这套基于数字的颜色系统并不容易,这要求您必须对混色和颜色匹配有良好的感觉。
您可以用函数 SetTextColor 和 SetBkColor 来“绘制”背景色和字符颜色,但是必须传递一个“设备环境”的句柄和 RGB 值作为参数。COLORREF类型用来描绘一个RGB颜色。其定义如下:
typedef DWORD COLORREF; typedef DWORD *LPCOLORREF; COLORREF类型变量值描绘一个颜色时对应于下面16进制的格式:
0x00bbggrr 可以用这样一个结构体来描述。 RGB_value struct {
byte unused ; byte blue ; byte green ; byte red;
};
其中第一字节为 0 而且始终为 0,其它三个字节分别表示兰色、绿色和红色,刚好和 RGB 的次序相反。这个结构体用起来挺别扭。对于COLORREF,我们通常使用宏RGB对其进行赋值。
宏的定义如下:
COLORREF RGB
(
BYTE byRed, // red component of color
BYTE byGreen, // green component of color
BYTE byBlue // blue component of color
);
您可以调用 CreateFont 和 CreateFontIndirect 来创建自己的字体,这两个函数的差别是前者要求 您传递一系列的参数,而后着只要传递一个指向 LOGFONT 结构的指针。这样就使得后者使用起来更方便,尤其当您需要频繁创建字体时。在我们的例子中由于只要创建一种字体,故用 CreateFont 就足够了。在调用该函数后会返回所创建的字体的句柄,然后把该句柄选进“设备环境”使其成为当前字体,随后所有的“绘制”文本串的函数在被调用时都要把该句柄作为一个参数传递。
例子: (见光盘FirstWindow3)
1 #include "Windows.h" 2 #include "tchar.h" 3 4 HWND hWinMain; 5 TCHAR szClassName[] = _T("MyClass"); 6 TCHAR szCaptionMain[] = _T("My First Window!"); 7 TCHAR szText[] = _T("Win32 program, Simple and powerful !"); 8 TCHAR FontName[] = _T("script"); 9 WNDCLASSEX stdWndClass; 10 11 LRESULT CALLBACK ProcWinMain(HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam ) 12 { 13 PAINTSTRUCT stPs; 14 HDC hDC; 15 HFONT hFont,hOldFont; 16 switch(Msg) 17 { 18 case WM_PAINT: 19 { 20 hDC = BeginPaint(hWnd,&stPs); 21 hFont = CreateFont(24,16,0,0,400,0,0,0,OEM_CHARSET,OUT_DEFAULT_PRECIS, 22 CLIP_DEFAULT_PRECIS,DEFAULT_QUALITY,DEFAULT_PITCH | FF_SCRIPT,FontName); 23 24 hOldFont = (HFONT)SelectObject(hDC,hFont); 25 SetTextColor(hDC,RGB(200,200,50)); 26 SetBkColor(hDC,RGB(0,0,255)); 27 TextOut(hDC,0,0,szText,sizeof(szText)); 28 SelectObject(hDC,hOldFont); 29 EndPaint(hWnd,&stPs); 30 } 31 break; 32 33 case WM_DESTROY: 34 { 35 PostQuitMessage(NULL); 36 } 37 break; 38 39 default: 40 return DefWindowProc(hWnd, Msg, wParam, lParam ); 41 } 42 return 0; 43 } 44 45 int WINAPI WinMain(HINSTANCE hInstance,HINSTANCE hPrevInstance,LPSTR lpCmdLine,int nCmdShow) 46 { 47 MSG stMsg; 48 WNDCLASSEX stdWndClass; 49 RtlZeroMemory(&stdWndClass, sizeof(stdWndClass)); 50 stdWndClass.hCursor = LoadCursor(0,IDC_ARROW); 51 stdWndClass.cbSize = sizeof(stdWndClass); 52 stdWndClass.style = CS_HREDRAW|CS_VREDRAW; 53 stdWndClass.lpfnWndProc = ProcWinMain; 54 stdWndClass.hbrBackground = (HBRUSH)COLOR_WINDOW; 55 stdWndClass.lpszClassName = szClassName; 56 stdWndClass.hInstance = hInstance; 57 58 RegisterClassEx(&stdWndClass); 59 60 hWinMain = CreateWindowEx(WS_EX_CLIENTEDGE,szClassName,szCaptionMain,61 WS_OVERLAPPEDWINDOW,100,100,600,400,NULL,NULL,hInstance,NULL); 62 63 if(!hWinMain) 64 return 0; 65 66 ShowWindow(hWinMain,SW_SHOWNORMAL); 67 UpdateWindow(hWinMain); 68 69 while(GetMessage(&stMsg,NULL,0,0)) 70 { 71 TranslateMessage(&stMsg); 72 DispatchMessage(&stMsg); 73 } 74 75 return stMsg.wParam; 76 }
分析:
CreateFont 函数产生一种逻辑字体,它尽可能地接近参数中指定的各相关值。这个函数大概是所有 Windows API函数中所带参数最多的一个。它返回一个指向逻辑字体的句柄供调用 SelectObject 函数使用。下面我们详细讲解该函数的参数:
HFONT CreateFont( int nHeight, // height of font int nWidth, // average character width int nEscapement, // angle of escapement int nOrientation, // base-line orientation angle int fnWeight, // font weight DWORD fdwItalic, // italic attribute option DWORD fdwUnderline, // underline attribute option DWORD fdwStrikeOut, // strikeout attribute option DWORD fdwCharSet, // character set identifier DWORD fdwOutputPrecision, // output precision DWORD fdwClipPrecision, // clipping precision DWORD fdwQuality, // output quality DWORD fdwPitchAndFamily, // pitch and family LPCTSTR lpszFace // typeface name );
nHeight: 希望使用的字体的高度,0为缺省。 nWidth: 希望使用的字体的宽度,一般情况下最好用0, 这样 Windows 将会自动为您选择一个和高度匹配的值。因为在我们的例子中那样做的话会使得字符因太小而无法显示,所以 我 们设定它为16。 nEscapement: 每一个字符相对前一个字符的旋转角度,一般设成0。900代表转90度,1800转190度,2700转270度。 nOrientation: 字体的方向。 nWeight: 字体笔画的粗细。
Windows 为我们预定义了如下值:
FW_DONTCARE 等于 0 FW_THIN 等于 100 FW_EXTRALIGHT 等于 200 FW_ULTRALIGHT 等于 200 FW_LIGHT 等于 300 FW_NORMAL 等于 400 FW_REGULAR 等于 400 FW_MEDIUM 等于 500 FW_SEMIBOLD 等于 600 FW_DEMIBOLD 等于 600 FW_BOLD 等于 700 FW_EXTRABOLD 等于 800 FW_ULTRABOLD 等于 800 FW_HEAVY 等于 900 FW_BLACK 等于 900
cItalic: 0为正常,其它值为斜体。 cUnderline: 0为正常,其它值为有下划线。 cStrikeOut: 0为正常,其它值为删除线。 cCharSet: 字体的字符集。一般选择OEM_CHARSET,它使得 Windows 会选用和操作系统相关的字符集。 cOutputPrecision: 指定我们选择的字体接近真实字体的精度。 一般选用OUT_DEFAULT_PRECIS,它决定了缺省的映射方式。 cClipPrecision: 指定我们选择的字体在超出裁剪区域时的裁剪精度。 一般选用CLIP_DEFAULT_PRECIS,它决定了裁剪精度。 cQuality: 指定输出字体的质量。它指出GDI应如何尽可能的接近真实 字体,一共有三种方式:DEFAULT_QUALITY, PROOF_QUALITY 和DRAFT_QUALITY。 cPitchAndFamily:字型和字体家族。 lpFacename: 指定字体的名称。
上面的描述不一定好理解,您如果要的到更多的信息,应参考 MSDN。
hOldFont = (HFONT)SelectObject(hDC,hFont);
在我们得到了指向逻辑字体的句柄后必须调用 SelectObject 函数把它选择进“设备环境”,我们还可以调用该函数把诸如此类的像颜色、笔、画刷 等GDI对象选进“设备环境”。该函数会返回一个旧的“设备环境”的句柄。您必须保存该句柄,以便在完成“绘制”工作后再把它选回。在调用 SelectObject 函数后一切的绘制函数都是针对该“设备环境”的。
SetTextColor(hDC,RGB(200,200,50)); SetBkColor(hDC,RGB(0,0,255));
我们用宏 RGB 产生颜色,然后分别调用 SetTextColor 和 SetBkColor。
TextOut(hDC,0,0,szText,sizeof(szText));
我们调用 TextOut 在客户区用我们前面选定的字体和颜色“绘制”文本串。
SelectObject(hDC,hOldFont);
在我们“绘制”完成后,必须恢复“设备环境”。我们必须每一次都这么做。