DrawText()

深碍√TFBOYSˉ_ 2022-08-05 11:18 26阅读 0赞

## [DrawText()][DrawText] ##

http://www.cnblogs.com/wangyang-sust/archive/2012/08/18/2645918.html

# DrawText #

####  ####

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

## int DrawText(HDC hDC, // 设备描述表句柄 　　LPCTSTR lpString, // 将要绘制的字符串 　　int nCount, // 字符串的长度 　　LPRECT lpRect, // 指向矩形结构RECT的指针 　　UINT uFormat // 正文的绘制选项 　　); ##

##  ##

hdc：输入\]设备环境句柄。

lpString：\[输入\]指向将被写入的字符串的指针，如果参数nCount是-1，则字符串必须是以\\0结束的。

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

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

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

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

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word; width:1058px; height:793px"> 
 <tbody> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">值</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">说明</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_BOTTOM</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">将正文调整到矩形底部。此值必须和DT_SINGLELINE组合。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_CALCRECT</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">决定矩形的宽和高。&nbsp; 如果正文有多行，DrawText使用lpRect定义的矩形的宽度，并扩展矩形的底部以容纳正文的最后一行。&nbsp; 如果正文只有一行，则DrawText改变矩形的右边界，以容纳下正文行的最后一个字符。&nbsp; 出现上述任何一种情况，DrawText返回格式化正文的高度，而不是绘制正文。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_CENTER</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">使正文在矩形中水平居中。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_EDITCONTROL</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">复制多行编辑控制的正文显示特性。&nbsp; 特殊地，为编辑控制的平均字符宽度是以同样的方法计算的，此函数不显示只是部分可见的最后一行。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_END_ELLIPSIS</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">对于显示的文本，如果结束的字符串的范围不在矩形内，它会被截断并以省略号标识。&nbsp; 如果一个字母不是在字符串的末尾处超出了矩形范围，它不会被截断并以省略号标识。&nbsp; 字符串不会被修改，除非指定了DT_MODIFYSTRING标志。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_EXPANDTABS</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">扩展制表符，每个制表符的缺省字符数是8。&nbsp; DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS和DT_END_ELLIPSIS不能和此参数一起使用</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_EXTERNALLEADING</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">在行的高度里包含字体的外部标头，通常，外部标头不被包含在正文行的高度里。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_HIDEPREFIX</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">忽略正文中的前缀字符（&amp;），并且前缀字符后面的字母不会出现下划线。其它前缀字符的调用方式不受影响。&nbsp; 输入的字符串： "A&amp;bc&amp;&amp;d"&nbsp; 正常： "Abc&amp;d"&nbsp; DT_HIDEPREFIX: "Abc&amp;d"</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_INTERNAL</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">用系统字体来计算正文度量。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_LEFT</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">正文左对齐。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_MODIFYSTRING</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">修改给定的字符串来匹配显示的正文。&nbsp; 此标志必须和DT_END_ELLIPSIS 或 DT_PATH_ELLIPSIS同时使用。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_NOCLIP</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">无裁剪绘制。当DT_NOCLIP使用时DrawText的使用会有所加快。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_NOFULLWIDTHCHARBREAK</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">在宽字符的字符串中防止行断开，因此折行规则相当于单字符的字符串。&nbsp; 例如，我们可以用在棒子版的windows中，为图标标签提供更好的可读性。&nbsp; 除非指定DT_WORDBREAK，否则此值没有作用。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_NOPREFIX</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">关闭前缀字符的处理。&nbsp; 通常DrawText解释助记前缀字符，&amp;为给其后的字符加下划线，解释&amp;&amp;为显示单个&amp;。指定DT_NOPREFIX，这种处理被关闭。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_PATH_ELLIPSIS</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">对于显示的正文，替换字符串在椭圆中的字符，以确保结果能在合适的矩形内。&nbsp; 如果该字符串包含反斜杠（\）字符，DT_PATH_ELLIPSIS尽可能的保留最后一个反斜杠之后的正文。&nbsp; 字符串不会被修改，除非指定了DT_MODIFYSTRING标志。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_PREFIXONLY</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">仅仅在（&amp;）前缀字符的位置下绘制一个下划线。不绘制字符串中的任何其他字符。&nbsp; 输入的字符串： "A&amp;bc&amp;&amp;d"&nbsp; 正常： "Abc&amp;d"&nbsp; DT_PREFIXONLY:" _ "</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_RIGHT</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">正文右对齐。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_RTLREADING</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">当选择进设备环境的字体是希伯来文或阿拉伯文字体时，为双向正文安排从右到左的阅读顺序都是从左到右的。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_SINGLELINE</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">显示正文的同一行，回车和换行符都不能折行。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_TABSTOP</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">设置制表，参数uFormat的15"C8位（低位字中的高位字节）指定每个制表符的字符数，每个制表符的缺省字符数是8。&nbsp; 注意：DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL,&nbsp; DT_NOCLIP, DT_NOPREFIX值不能和DT_TABSTOP值一起使用。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_TOP</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">正文顶端对齐。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_VCENTER</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">使正文在矩形中垂直居中。&nbsp; (DreamSmart注：此值必须和DT_SINGLELINE连用，否则GDI无法计算目的矩形)</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_WORDBREAK</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">断开字。当一行中的字符将会延伸到由lpRect指定的矩形的边框时，此行自动地在字之间断开。一个回车一换行也能使行折断。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">DT_WORD_ELLIPSIS</td> 
 <td style="border:1px solid silver; border-collapse:collapse; padding:3px">截短不符合矩形的正文，并增加省略号。</td> 
 </tr> 
 </tbody> 
</table>

## 　返回值 如果函数调用成功，返回值是正文的高度（逻辑单位）。如果指定了DT\_VCENTER或DT\_BOTTOM，返回值是lpRect->top到绘制的正文的底部的偏移值。 　　如果函数调用失败，返回值是0 　　Windows NT：若想获得更多错误信息，请调用[GetLastError][]函数。 ##

## 备注 ##

函数DrawText用设备环境中的字体选择、正文颜色和背景颜色来写正文。DrawText裁剪正文，不会出现在指定矩形的外面，除非指定了DT\_NOCLIP。除非使用DT\_SINGLELINE格式化，否则其余的格式都认为正文有多行。 　　如果选择的字体对指定的矩形而言太大，DrawText不会试图去换成一种小字体。 　　DrawText支持纵和方向均为0的字体。 　　设备环境的正文对齐方式必须包括TA\_LEFT, TA\_TOP和TA\_NOUPDATECP标志。 　　Windows CE：如果为参数uFormat指定DT\_CALCRECT值，必须为lpRect指向的RECT结构设置right和bottom成员。Windows CE不支持uFormat为DT\_EXTERNALLEADING。

##  ##

[DrawText]: http://www.cnblogs.com/wangyang-sust/archive/2012/08/18/2645918.html
[Link 1]: http://baike.baidu.com/view/266782.htm
[GetLastError]: http://baike.baidu.com/view/1730168.htm