MFC常用函数以及值得注意的地方(第1篇)

目录:

1.DrawText() 

2.取高字节,低字节

3.如果字符串太长了,一行写不尽怎么办?

4.CString::Format函数使用要注意的问题!

 

1.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_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。

 

2.取高字节,低字节

利用宏定义

16 bit
BYTE HIBYTE(  WORD wValue );
BYTE LOBYTE(  WORD wValue );

32bit的
WORD HIWORD(  DWORD dwValue );
WORD LOWORD(  DWORD dwValue );

 

3.如果字符串太长了,一行写不尽怎么办?

  可以这样写:

 

CString statue;

statue.Format(_T("头部标识:%d\n"\

"最后页字节数: %d\n"), 

pDoc->pHeader->e_magic, /*头部标识*/

pDoc->pHeader->e_cblp);/*文件最后页的字节数*/

   当然,也有人 喜欢这样写:

   CString str = "I love you,\

  you love me!Too!"

当然这样写也可以,只不过str在I love you,之后会加上许多空格!


4.CString::Format函数使用要注意的问题!

比如说,当我们要格式化输入一个字符串的时候,我们可以这样做:

Format(%s, pStr);

pStr是指向一个字符串的指针!这个时候要注意了,如果pStr指向了一个不用’\0’结尾的字符串,那怎么办?

如果这样的话,程序会出错!你要尽量避免这种情况!

CString类的Format函数使用起来特别方便!使用方法如下:

函数声明

function Format(const Format: string; const Args: array of const): string; overload; 

(事实上Format方法有两个种形式,另外一种是三个参数的,主要区别在于它是线程安全的,但并不多用,所以这里只对第一个介绍)

参数:

1、Format参数是一个格式字符串,用于格式化Args里面的值的。格式字符串中包含了一个或多个以%字符开始的格式指令,我们通过这些格式指令来编译器如何对Args里面的值进行格式!以下是不同类型数据的格式方式%号后的说明: (后面会举例说明各格式命令)

d输出带符号十进制数

o输出无符号八进制数 

x输出无符号十六进制数 

u输出无符号数 

c输出单个字符 

s输出一串字符 

f输出实数(6位小数) 

e以指数形式输出实数 

g选用f与e格式中输出宽度较小的格式,不输出0 

ld输入输出long型数据 

lf输入输出double型数据 

m数据输出宽度为m 

.n输出小数位数为n

 

2、Args是一个变体数组,即它里面可以有多个参数,而且每个参数可以不同。

 

如以下例子:  

Format("my name is %6s","wind");  

返回后就是  

my name is wind  

 

现在来看Format参数的详细情况:  

Format里面可以写普通的字符串,比如"my name is"  

但有些格式指令字符具有特殊意义,比如"%6s"  

 

格式指令具有以下的形式:  

"%" [index ":"] ["-"] [width] ["." prec] type  

它是以"%"开始,而以type结束,type表示一个具体的类型。中间是用来格式化type类型的指令字符,是可选的。  

 

先来看看type,type可以是以下字符:  

d 十制数,表示一个整型值  

u 和d一样是整型值,但它是无符号的,而如果它对应的值是负的,则返回时是一个2的32次方减去这个绝对值的数  

Format("this is %u",-2);  

返回的是:this is 4294967294 

 

f 对应浮点数  

e 科学表示法,对应整型数和浮点数,  

Format("this is %e",-2.22);  

返回的是:this is -2.220000E+000 

等一下再说明如果将数的精度缩小 

 

g 这个只能对应浮点型,且它会将值中多余的数去掉  

Format("this is %g",02.200);  

返回的是:this is 2.2 

 

n 只能对应浮点型,将值转化为号码的形式。看一个例子就明白了  

Format("this is %n",4552.2176);  

返回的是this is 4,552.22  

注意有两点:

一是只表示到小数后两位,等一下说怎么消除这种情况  

二是即使小数没有被截断,它也不会也像整数部分一样有逗号来分开的 

 

m 钱币类型,但关于货币类型有更好的格式化方法,这里只是简单的格式化,另外它只对应于浮点值  

Format("this is %m",9552.21);  

返回:this is ¥9,552.21 

 

 

p 对应于指针类型,返回的值是指针的地址,以十六进制的形式来表示  

例如:  

Format("this is %p",p);  

返回:this is 0012F548 

 

s 对应字符串类型,不用多说了吧 

 

 

x 必须是一个整形值,以十六进制的形式返回  

Format("this is %X",15);  

返回是:this is F  

 

类型讲述完毕,下面介绍格式化Type的指令:  

[index ":"] 这个要怎么表达呢,看一个例子  

Format("this is %d %d",12,13);  

其中第一个%d的索引是0,第二个%d是1,所以字符显示的时候是这样 

this is 12 13  

 

而如果你这样定义:  

Format("this is %1:d %0:d",12,13);  

那么返回的字符串就变成了  

this is 13 12  

现在明白了吗?

[index ":"] 中的index指示Args中参数显示的顺序 

 

 

还有一种情况,如果这样

Format("%d %d %d %0:d %d", 1, 2, 3, 4) ; 

将返回1 2 3 1 2。  

如果你想返回的是1 2 3 1 4,必须这样定:  

Format("%d %d %d %0:d %3:d", 1, 2, 3, 4) ; 

但用的时候要注意,索引不能超出Args中的个数,不然会引起异常  

Format("this is %2:d %0:d",12,13);  

由于Args中只有12 13 两个数,所以Index只能是0或1,这里为2就错了  

 

[width] 指定将被格式化的值占的宽度,看一个例子就明白了  

Format("this is %4d",12);  

输出是:this is 12  

这个是比较容易,不过如果Width的值小于参数的长度,则没有效果。  

如:Format("this is %1d",12);  

输出是:this is 12 

 

["-"] 这个指定参数向左齐,和[width]合在一起就可以看到效果:  

Format("this is %-4d,yes",12);  

输出是:this is 12 ,yes 

 

 

["." prec] 指定精度,对于浮点数效果最佳:  

Format(‘this is %.2f‘,[‘1.1234]);  

输出 this is 1.12  

Format(‘this is %.7f‘,[‘1.1234]);  

输了 this is 1.1234000  

 

而对于整型数,如果prec比如整型的位数小,则没有效果;反之比整形值的位数大,则会在整型值的前面以0补之  

Format(‘this is %.7d‘,[1234]);  

输出是:this is 0001234]  

 

对于字符型,刚好和整型值相反,如果prec比字符串型的长度大,则没有效果;反之比字符串型的长度小,则会截断尾部的字符  

Format(‘this is %.2s‘,[‘1234‘]);  

输出是 this is 12  

 

而上面说的这个例子:  

Format(‘this is %e‘,[-2.22]);  

返回的是:this is -2.22000000000000E+000  

怎么去掉多余的0呢,这个就行啦  

Format(‘this is %.2e‘,[-2.22]);  

 

 

MFC常用函数以及值得注意的地方(第1篇)

上一篇:Hadoop源码分析之NameNode的格式化


下一篇:[MySQL FAQ]系列 — MySQL复制中slave延迟监控