TextOut细节

TextOut是用于显示文本的最常用的GDI函数。语法是Text(hdc,x,y,psText,iLength);

参数一：hdc是设备描述表句柄，它既可以是GetDC的返回值，也可以是在处理WM_PAINT消息时BeginPaint的返回值。它的属性控制了被显示的文本串的特征。

参数二 和 参数三：x 和 y定义客户区内字符串的开始位置，x是水平位置，y是垂直位置。串中第一个字符的左上角位于坐标点(x,y)。在默认设备描述表中，原点（x和y均为0的点）是客户区的左上角。

参数三：psText参数是指向字符串的指针

参数四:iLength是串中字符的个数。如果psText指向Unicode字符串，则串中的字节数就是iLength值的两倍。  串中不能包含任何ASCII控制字符（如回车、换行、制表或退格），Windows会将这些控制字符显示为实心块。

TextOut不识别作为串尾标志的内容为零的字节（对于Unicode，是一个短整形的0），而需要iLength参数指明长度。

 

注：在阅读GDI绘图函数的文档时，例如TextOut，就会发现传递给函数的坐标常常被称为“逻辑坐标”。这以后具体说明。另外Windows有多种不同的“映射方式”，它们用来控制GDI绘图函数指定的逻辑坐标转换为显示器的物理像素坐标的方式。映射方式在设备描述表中定义，默认的映射方式是MM_TEXT（使用WINGDI.H头文件中定义的标识符）。在MM_TEXT映射方式下，逻辑单位与物理单位相同，都是相对于客户区左上角的像素数；x的值从左向右递增，y的值从上向下递增。MM_TEXT坐标系与Windows在PAINTSTRUCT结构中定义无效矩形时使用的坐标系相同，这为我们带来了很多方便，但是其他映射方式并非如此。