DrawText的使用

 DrawText函数简单介绍

    这个函数的作用很简单，就是在指定的区域内输出格式化的文本。

    函数原型：

int DrawText(

  HDC hDC,

  LPCTSTR lpString,

  int nCount,

  LPRECT lpRect,

  UNIT uFormat

);

    hDC是设备上下文句柄。lpString指向将要绘制的UNICODE文本。nCount是要输出的字符数，如果nCount = -1，则Windows自动计算字符数，不过此时lpString所指向的必须是以NULL结尾的字符串。lpRect指向rect结构体，指定了文本格式化的矩形区域。uFormat是格式化标记，也是这里面稍显复杂的一个参数。

    下面是几个常用的格式化标记：

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

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

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

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

② DrawText函数使用举例

    //Get the height and length of the string.

    DrawText(hdc,szHello,-1,&rect, DT_CALCRECT | DT_CENTER | DT_SINGLELINE);

    // Draw the text

    DrawText(hdc,szHello,-1,&rectCli,DT_CENTER | DT_SINGLELINE);

③ 经常与DrawText结合使用的几个函数

    (1) SetTextColor 设置文本前景色

COLORREF SetTextColor(

  HDC hdc,

  COLORREF crColor

);

(2) SetBkColor 设置文本背景色

COLORREF SetBkColor(

  HDC hdc,

  COLORREF crColor

);

    (3) SetBkMode 设备背景色模式为透明与不透明

int SetBkMode(

  HDC hdc,

  int iBkMode

);

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

编辑本段返回值

　　如果函数调用成功，返回值是正文的高度（逻辑单位）。如果指定了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。