【C++】DrawText()函数应用

函数说明

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

函数原型

intDrawText(HDC hdc, LPCTSTR lpString, int nCount, LPRECT lpRect, 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_VCENTER使正文在矩形中垂直居中。
(DreamSmart注:此参数必须和DT_SINGLE连用,否则GDI无法计算目的矩形)
DT_EDITCONTROL复制多行编辑控制的正文显示特性。
特殊地,为编辑控制的平均字符宽度是以同样的方法计算的,此函数不显示只是部分可见的最后一行。
DT_END_ELLIPSIS或DT_PATH_ELLIPSIS可以指定DT_END_ELLIPSIS来替换在字符串末尾的字符,或指定DT_PATH_ELLIPSIS来替换字符串中间的字符。
如果字符串里含有反斜扛(\),DT_PATH_ELLIPSIS尽可能地保留最后一个反斜杠之后的正文。
字符串不会被修改,除非指定了DT_MODIFYSTRING标志。
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_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, DT_NOPREFIX值不能和DT_TABSTOP值一起使用
DT_TOP正文顶端对齐(仅对单行)。DT_VCENTER:正文水平居中(仅对单行)。
DT_WORDBREAK断开字。当一行中的字符将会延伸到由lpRect指定的矩形的边框时,此行自动地在字之间断开。一个回车一换行也能使行折断。
DT_WORD_ELLIPSIS截短不符合矩形的正文,并增加椭圆。
DT_PREFIXONLY仅仅在(&)前缀字符的位置下绘制一个下划线。不绘制字符串中的任何其他字符。
输入的字符串: “A&bc&&d”
正常: “Abc&d”
DT_PREFIXONLY:" _ "

代码示例

void CViewDlg::OnPaint()
{
	CPaintDC dc(this); // device context for painting
	//内存DC
	int			x,y;
	CString		str;
    CDC 		mDC;
    if (!mDC.CreateCompatibleDC(&dc))
    {
        return;
    }
    CDC *pDC = &mDC;
	x = 10;
	y = 20;
	str.Format(_T("这是个测试"));
	CRect		rect(x, y, 60, y + 10);
	pDC->SetTextColor(RGB(255,0,0));
	pDC->DrawText(str, &rect, DT_LEFT);	
 	
 	//释放内存
    mDC.DeleteDC();
}

返回值

如果函数调用成功,返回值是正文的高度(逻辑单位)。
如果指定了DT_VCENTER或DT_BOTTOM,返回值是lpRect->top到绘制的正文的底部的偏移值。   如果函数调用失败,返回值是0   
Windows NT:若想获得更多错误信息,请调用GetLastError函数。

参考链接: DrawText.

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值