DrawText

int DrawText(HDC hDC, // handle to DCLPCTSTR lpString, // text to
drawint nCount, // text lengthLPRECT lpRect, // formatting
dimensionsUINT uFormat // text-drawing options);

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

最近在做一个TStringGrid的自绘处理,在画文字处理上遇到了高度的计算问题。后来经过一段时间还是找到了一些方法:

MSDN里的DrawText的nFormat的DT_WORDBREAK可以实现多行显示,可是试了很多次都不行,如果文本中有用空格,会自动在空格处换行。如果没有空格的话,仍然是单行显示。最后试了下DT_EDITCONTROL和DT_WORDBREAK组合使用才行,发现可以自动换行了。

 

 

各个参数的含意如下:

 

1、使用TLabel

  这个方法是有点绕路的,方法倒是简单,就是使用AutoSize属于来完成。。

参数: hdc:设备环境句柄。
lpString:指向将被写入的字符串的指针,如果参数nCount是C1,则字符串必须是以结束的。
如果uFormat包含DT_MODIFYSTRING,则函数可为此字符串增加4个字符,存放字符串的缓冲区必须足够大,能容纳附加的字符。
nCount:指向字符串中的字符数。如果nCount为C1,则lpString指向的字符串被认为是以结束的,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的15C8位指定每个制表符的字符数,每个制表符的缺省字符数是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。

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

2、使用DrawText

  DrawText的函数定义:

函数原型
int DrawText(

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

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

int nCount, // 字符串的长度

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

UINT uFormat // 正文的绘制选项

);

参数
hdc:

[输入]设备环境句柄。

lpString:

style=”font-size: 16px;”>[输入]指向将被写入的字符串的指针,如果参数nCount是-1,则字符串必须是以结束的。
如果uFormat包含DT_MODIFYSTRING,则函数可为此字符串增加4个字符,存放字符串的缓冲区必须足够大,能容纳附加的字符。

nCount:

style=”font-size: 16px;”>[输入]指向字符串中的字符数。如果nCount为-1,则lpString指向的字符串被认为是以结束的,DrawText会自动计算字符数。

lpRect:

style=”font-size: 16px;”>[输入/输出]指向结构RECT的指针,其中包含文本将被置于其中的矩形的信息(按逻辑坐标)。

uFormat:

style=”font-size: 16px;”>[输入]指定格式化文本的方法。它可以下列值的任意组合,各值描述如下:

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

style=”color: #ff0000; font-size: 16px;”>DT_CENTER:指定文本水平居中显示。

style=”color: #ff0000; font-size: 16px;”>DT_VCENTER:指定文本垂直居中显示。该标记只在单行文本输出时有效,所以它必须与DT_SINGLELINE结合使用。

style=”color: #ff0000; font-size: 16px;”>DT_SINGLELINE:单行显示文本,回车和换行符都不断行。

函数里面最后面那段蓝字标示的很重要,DT_CALCRECT就是用来计算文本尺寸的哦。。做个试验吧:

 

procedure TForm1.Button1Click(Sender: TObject);
var
  sData: string;
  cellRect: TRect;
begin
  cellRect.Left := 10;
  cellRect.Top := 10;
  cellRect.Right := 200;
  cellRect.Bottom := 25;
  sData := '中中国国国 大';
  DrawText(Canvas.Handle, PChar(sData), Length(sData), cellRect, DT_WORDBREAK or DT_CALCRECT);
end;
//执行后没有在界面上画文本

procedure TForm1.Button2Click(Sender: TObject);
var
  sData: string;
  cellRect: TRect;
begin
  cellRect.Left := 10;
  cellRect.Top := 10;
  cellRect.Right := 200;
  cellRect.Bottom := 25;
  sData := '中中国国国 大';
  DrawText(Canvas.Handle, PChar(sData), Length(sData), cellRect, DT_WORDBREAK);
end;
//执行后在界面上显示一行字

 

注意点:

  • 这里有一点,DrawText计算后的矩形大小还是通过cellRect来返回的哦。这个参数传入时是做为计算文本显示的矩形大小,返回时就是文本实际占用的矩形大小。
  • 同时DrawText运算后也会有函数返回值的,就是文本实际的高度。

 

  hdc:输入]设备环境句柄。  

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

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

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

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

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

说明
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。

You can leave a response, or trackback from your own site.

Leave a Reply

网站地图xml地图