DrawText函数的讲解

函数原型

int DrawText(

HDC hDC, // 设备描述表句柄

LPCTSTR lpString, // 将要绘制的字符串

int nCount, // 字符串的长度

LPRECT lpRect, // 指向矩形结构RECT的指针

UINT uFormat // 正文的绘制选项

);

参数

hdc：

[输入]设备环境句柄。

lpString：

[输入]指向将被写入的字符串的指针，如果参数nCount是-1，则字符串必须是以\0结束的。 如果uFormat包含DT_MODIFYSTRING，则函数可为此字符串增加4个字符，存放字符串的缓冲区必须足够大，能容纳附加的字符。

nCount：

[输入]指向字符串中的字符数。如果nCount为-1，则lpString指向的字符串被认为是以\0结束的，DrawText会自动计算字符数。

lpRect：

[输入/输出]指向结构RECT的指针，其中包含文本将被置于其中的矩形的信息（按逻辑坐标）。

uFormat：

[输入]指定格式化文本的方法。它可以下列值的任意组合，各值描述如下：

DT_CALCRECT：这个参数比较重要，可以使DrawText函数计算出输出文本的尺寸。如果输出文本有多行，DrawText函数使用lpRect定义的矩形的宽度，并扩展矩形的底部以容纳输出文本的最后一行。如果输出文本只有一行，则DrawText函数改变矩形的右边界，以容纳下正文行的最后一个字符。出现上述任何一种情况，DrawText函数将返回格式化文本的高度，而不是绘制文本。

DT_CENTER：指定文本水平居中显示。

DT_VCENTER：指定文本垂直居中显示。该标记只在单行文本输出时有效，所以它必须与DT_SINGLELINE结合使用。

DT_SINGLELINE：单行显示文本，回车和换行符都不断行。

 

功能

该函数的功能是在指定的矩形里写入格式化文本，根据指定的方法对文本格式化（扩展的制表符，字符对齐、折行等）

要指定额外的格式化选项，请使用DrawTextEx函数。

 

返回值

如果函数调用成功，返回值是正文的高度（逻辑单位）。如果指定了DT_VCENTER或DT_BOTTOM，返回值是lpRect->top到绘制的正文的底部的偏移值。

如果函数调用失败，返回值是0

Windows NT：若想获得更多错误信息，请调用GetLastError函数。