CDC::DrawText

 

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

当指定参数为 DT_WORDBREAK 时 ,DrawText 就有了自动识别单词的功能 , 它会把连在一起的英文字符或数字识了一个单词 , 当一行显示不下时 , 它会自动跳转到下一行显示 , 当单词的长度超过矩形的宽度时 , 该单词就不能完全显示了

函数原型： int DrawText(HDC, hdc, LPCTSTR lpString, int nCount, LPREST lpRect, UINT uFormat) ；

 

    参数：

 

    hdc ：设备环境句柄。

 

    lpString ：指向将被写入的字符串的指针，如果参数 nCount 是 C1 ，则字符串必须是以 /0 结束的。

 

    如果 uFormat 包含 DT_MODIFYSTRING ，则函数可为此字符串增加 4 个字符，存放字符串的缓冲区必须足够大，能容纳附加的字符。

 

    nCount ：指向字符串中的字符数。如果 nCount 为 C1 ，则 lpString 指向的字符串被认为是以 /0 结束的， DrawText 会自动计算字符数。

 

    lpRect ：指向结构 RECT 的指针，其中包含正文将被置于其中的矩形的信息（按逻辑坐标）。

 

    uFormat ：指定格式化正文的方法。它可以下列值的任意组合，各值描述如下：

 

    DT_BOTTOM ：将正文调整到矩形底部。此值必须和 DT_SINGLELINE 组合。

 

    DT_CALCRECT ：决定矩形的宽和高。如果正文有多行， DrawText 使用 lpRect 定义的矩形的宽度，并扩展矩形的底训以容纳正文的最后一行，如果正文只有一行，则 DrawText 改变矩形的右边界，以容纳下正文行的最后一个字符， 上述任何一种情况， DrawText 返回格式化正文的高度而不是写正文 。

 

    DT_CENTER ：使正文在矩形中水平居中。

 

    DT_EDITCONTROL ：复制多行编辑控制的正文显示特性，特殊地，为编辑控制的平均字符宽度是以同样的方法计算的，此函数不显示只是部分可见的最后一行。

 

    DT_END_ELLIPSIS 或 DT_PATH_ELLIPSIS ：可以指定 DT_END_ELLIPSIS 来替换在字符串末尾的字符，或指定 DT_PATH_ELLIPSIS 来替换字符串中间的字符。如果字符串里含有反斜扛， DT_PATH_ELLIPSIS 尽可能地保留最后一个反斜杠之后的正文。

 

    DT_EXPANDTABS ：扩展制表符，每个制表符的缺省字符数是 8 。

 

    DT_EXTERNALLEADING ：在行的高度里包含字体的外部标头，通常，外部标头不被包含在正文行的高度里。

 

    DT_INTERNAL ：用系统字体来计算正文度量。

 

    DT_LEFT ：正文左对齐。

 

    DT_MODIFYSTRING ：修改给定的字符串来匹配显示的正文，此标志必须和 DT_END_ELLIPSIS 或 DT_PATH_ELLIPSIS 同时使用。

 

   DT_NOCLIP ：无裁剪绘制当 DT_NOCLIP 使用时 DrawText 的使用会有所加快。

 

    DT_NOPREFIX ：关闭前缀字符的处理，通常 DrawText 解释助记前缀字符， & 为给其后的字符加下划线，解释 && 为显示单个 & 。指定 DT_NOPREFIX ，这种处理被关闭。

 

    DT_RIGHT ：正文右对齐。

 

    DT_RTLREADING ：当选择进设备环境的字体是 Hebrew 或 Arabicf 时，为双向正文安排从右到左的阅读顺序都是从左到右的。

 

    DT_SINGLELINE ：显示正文的同一行，回车和换行符都不能折行。

 

    DT_TABSTOP ：设置制表，参数 uFormat 的 15"C8 位（低位字中的高位字节）指定每个制表符的字符数，每个制表符的缺省字符数是 8 。

 

    DT_TOP ：正文顶端对齐（仅对单行）。 DT_VCENTER ：正文水平居中（仅对单行）。

 

    DT_WORDBREAK ：断开字。当一行中的字符将会延伸到由 lpRect 指定的矩形的边框时，此行自动地在字之间断开。一个回车一换行也能使行折断。

 

    DT_WORD_ELLIPSIS ：截短不符合矩形的正文，并增加椭圆。

 

    注意： DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, DT_NOPREFIX 值不能和 DT_TABSTOP 值一起使用。

 

    返回值：如果函数调用成功，返回值是正文的高度；如果函数调用失败，返回值是 0 。

 

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

 

    备注：函数 DrawText 用设备环境中的字体选择、正文颜色和背景颜色来写正文，除非 DT_NOCLIP 被使用， DrawText 裁剪正文，所以它不会出现在指定矩形的外面，除 DT_SINGLELINE 格式化，其余的格式都认为正文有多行。

 

    如果选择的字体对指定的矩形而言太大， DrawText 不会试图去换成一种小字体。

 

    Windows CE ：如果为参数 uFormat 指定 DT_CALCRECT 值，必须为 lpRect 指向的 RECT 结构设置 right 和 bottom 成员。 Windows CE 不支持 uFormat 为 DT_EXTERNALLEADING 。