使用 DrawText() 向客户区的中间位置输出了一段文本,说一下文字的输出。
设备环境(DC)
在Windows中,一切能在显示器上看到的都是图形,不但包括点、线、矩形、圆等,也包括文字、字体。对用户来说文字和图片是不同的,但它们在本质上都是图形,都需要在显示器上画出来。这也是Windows被称作图形操作系统的原因。
Windows不允许我们直接访问硬件,如键盘、显示器、打印机等,在与这些硬件通信前要获得设备环境(Device Context,简称 DC),进而间接的访问硬件。
设备环境有时也被称为设备上下文或设备描述表。
所谓设备环境,就是与当前硬件设备有关的各种信息,它是硬件设备的抽象。也就是说,设备环境就代表当前的硬件。
与文字输出、图形绘制有关的函数,在使用时大都需要传入一个参数,就是设备环境句柄。获取设备环境句柄有多种方式,常用的是 BeginPaint
函数。绘图完成后,还要释放句柄,使用 EndPaint
函数。
BeginPaint 和 EndPaint 函数
当发生 WM_PAINT
事件时,应用程序开始绘图。绘图之前需要先调用 BeginPaint
函数通知 Windows,告诉它当前程序需要使用显示器,你安排一下吧。BeginPaint
函数执行完毕就返回设备环境句柄,接下来就可以使用 GDI 函数绘图了。
绘图结束后,也需要调用 EndPaint
函数通知Windows,告诉它绘图结束了,可以继续后面的工作了。
TextOut 函数
TextOut 函数可以在客户区输出一段文本,原型为:
BOOL TextOut(
HDC hdc, //设备环境句柄
int nXStart, //开始输出位置的x坐标
int nYStart, //开始输出位置的y坐标
LPCTSTR lpString, //要输出的字符串
int cbString //字符串的长度
);
每当发生WM_PAINT
事件时,窗口就会发生重绘,这个时候需要向窗口输出文字:
LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
HDC hdc; //设备环境句柄
PAINTSTRUCT ps; //存储绘图环境的相关信息
TCHAR szText[20] = TEXT("欢迎来到北京!");
switch (message)
{
//窗口绘制消息
case WM_PAINT:
hdc = BeginPaint(hwnd, &ps); //开始绘图并返回环境句柄
//输出文字
TextOut(hdc, 50, 50, szText, wcslen(szText));
EndPaint(hwnd, &ps); //结束绘图并释放环境句柄
return 0;
//窗口销毁消息
case WM_DESTROY:
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, message, wParam, lParam);
}
运行效果:
几点说明:
-
PAINTSTRUCT
结构体用来保存与绘图环境有关的信息。 -
BeginPaint
和EndPaint
函数用来开始绘图和结束绘图,必须成对出现,输出文字或绘制图形的代码也必须放在两个函数之间。 -
字符串一般使用宽字符,对应的计算字符串长度的函数为
wcslen()
。
DrawText函数
TextOut
在一个起点开始输出文本,可以精确定位,不能自动换行;DrawText
在指定区域内输出文本,可以控制格式对齐(居左、居中、居右),可以换行。
DrawText
在内部其实也是调用TextOut
,不过它作了很多处理,比如 DrawText
无需知道输出多少个字符。更重要的是,DrawText
可以处理换行符而 TextOut
不能,从这个角度看,DrawText
应该是一种更高级的用法,是在TextOut
基础上的封装。
DrawText 的原型是:
int DrawText(
HDC hDC, //设备环境句柄
LPCTSTR lpString, //将要输出的字符串
int nCount, //字符串的长度
LPRECT lpRect, //指向一个矩形区域的结构体 RECT 的指针
UINT uFormat //输出格式
);
两点说明:
-
如果 nCount 为 -1,则表明 lpString 指向的字符串是以
'\0'
结束的,DrawText 会自动计算字符数。 -
参数 uFormat 有四种取值,它们可以任意组合:
- DT_CALCRECT:这个参数比较重要,可以使 DrawText 函数计算出输出文本的尺寸。如果输出文本有多行,DrawText函数
使用 lpRect 定义的矩形的宽度,并扩展矩形的底部以容纳输出文本的最后一行。如果输出文本只有一行,则 DrawText函数
改变矩形的右边界,以容纳下正文行的最后一个字符。出现上述任何一种情况。
- DT_CENTER:指定文本水平居中显示。
- DT_VCENTER:指定文本垂直居中显示。该标记只在单行文本输出时有效,所以它必须与DT_SINGLELINE结合使用。
- DT_SINGLELINE:单行显示文本,回车和换行符都不断行。
DrawText 示例:
LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
HDC hdc; //设备环境句柄
PAINTSTRUCT ps;
RECT rect;
switch (message)
{
//窗口绘制消息
case WM_PAINT:
hdc = BeginPaint(hwnd, &ps);
GetClientRect(hwnd, &rect);
DrawText(
hdc,
TEXT("欢迎你!"),
- 1,
&rect,
DT_SINGLELINE | DT_CENTER | DT_VCENTER
);
EndPaint(hwnd, &ps);
return 0;
//窗口销毁消息
case WM_DESTROY:
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, message, wParam, lParam);
}
运行结果:
改变窗口大小时,文本会自动调整位置,一直处于窗口中间。
GetClientRect
函数用来获得窗口客户区的坐标,也就是获得客户区这个矩形。