函数原型
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_VCENTER |
使正文在矩形中垂直居中。 (DreamSmart注:此参数必须和DT_SINGLE连用,否则GDI无法计算目的矩形) |
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_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。
分享到:
相关推荐
更多内容见: VC共享乐园vcshare.net 何丹的论坛hedanwang.cn/bbs/
博客《android Graphics( 五):drawText()详解》对应源码
No such filter: 'drawtext' MacOs:node+ffmpeg+web 利用node+ffmpeg 在浏览器上播放rtsp流,所需要的ffmpeg;一般官网上下载的和默认自己编译的都不包含 drawtext filter;该工具包包含,可直接使用 macOs可直接...
本资源为博主自己编译的,具有drawtext功能的FFmpeg。里面包含的ffmpeg.exe和dll,均具有drawtext功能。功能测试已通过。可在32位和64位系统运行。为根据博文《执行FFmpeg命令时报错:No such filter: 'drawtext'》...
解决DrawText中文字与字母之间自动换行
嗨,我设计了一个自定义TreeView控件,当树调整大小时,该控件包装了树项的文本字符串,并且为了实现在OnPaint()处理程序中绘制树项,我使用CDC :: DrawText()来绘制文本字符串和CDC :: FillRect()在同一矩形...
Android DrawText字符串的绘制 Android DrawText字符串的绘制
drawText 一个js库,可在画布上创建和编辑文本。 例子 参见 #Limitations已使用ubuntu chrome测试。
Draw a Text in PictureBox by using DrawText API Code
通达信指标公式编写教程:绘图函数DRAWLINE、DRAWTEXT等终版.pdf
MFC环境下文本输出,包括路径层,DrawText函数使用等
利用drawtext给视频加字幕,忽略音频,只处理一个流视频
let mut draw_text = DrawText::new(device.clone(), queue.clone(), swapchain.clone(), &images); 通过调用queue_text指定要绘制的文本: draw_text.queue_text(200.0, 50.0, 20.0, [1.0, 1.0, 1.0, 1.0], "Th
VC++在窗体上输出文本的实例,主要是利用DrawText方法来实现文字输出,为了更全面一些,实例中不但输出了英文字符,还输出了中文,如果您对DrawText的使用方法不熟悉,可下载本源码参考。 运行环境:Windows/Visual...
'参数3:字体宽 参数4:字体高 参数5:字体粗细(标准为400) '参数6:字体 参数7:打印内容 LxPrint.DrawText 1000, 1000, 300, 1000, 400, "宋体", "万军" LxPrint.DrawText 2000, 2000, 1000, 500, 400, "宋体", ...
graphics 画文字 C# VS2008 DrawText
用Directx8绘制2D文字源码
用DrawText函数显示html格式内容,可以实现字体高亮显示
MFC文本输出函数DrawText,TabbedTextOut
ffmpeg -t 3 -ss 01:07:10 -i 'AMWF White Schoolgirl Teen.mp4' -vf "drawtext=:text="六斗米gif":x=8:y=8:fontsize=25:fontcolor=black@0.5" -s 450x270 -r 5 ~/Pictures/thumbs/small-clip21.gif