GDI(图形设备接口)编程(二)TextOut

TextOut是显示文本最重要的GDI函数。TextOut是一种兼容的写法定义了UNICODE时表示TextOutW，否则表示TextOutA。

以TextOutA为例，函数原型如下：

BOOL  WINAPI TextOutA(HDC hdc, int x, int y, LPCSTR psText, int iLength);

第一个参数是一个设备环境句柄，设备环境中的属性决定了文本显示的特性。设备环境中的一个属性，决定了文本的颜色，默认是黑色。设备环境同时默认文字背景为白色。

当程序输出文本时，Windows将使用这个背景色填充每个字符的周边矩形区域（我们称之为字符框）。

参数psText一个指向字符串的指针，而iLength指字符串的长度。字符串中不应该有任何的ACSII控制字符，例如回车、换行符、制表符或者退格符。Windows将这些控制字符显示为空心或者实心方块。TextOut并不认为字符串末尾的0字节(对UNICODE来说是0双字节)表示字符串结束，它利用iLength参数来决定字符串的长度。

参数x，y决定输出字符串在客户区的位置。x水平位置，y垂直位置。在类似于TextOut的GDI绘图函数中，传递给绘图函数的坐标被称为“逻辑坐标”。Windows有各种映射模式

决定GDI绘图函数的逻辑坐标怎样转换成显示器上的物理像素坐标。在默认的MM_TEXT中，逻辑坐标和物理坐标的单位都是像素。

在调用TextOut时，Window将不会显示字符串掉落在设备环境维护的裁剪区以外的部分。