TextOut is not supported on CE , use DrawText or ExtTextOut

TextOut is not supported on CE , use DrawText or ExtTextOut

 

 

 

http://www.bolingconsulting.com/progwince.htm

 

 

 

ExtTextOut

 

　　函数功能：该函数用当前选择的字体、背景颜色和正文颜色来绘制一个字符串。可以提供一个可选的矩形，用于裁剪或作不透明物或两者兼有。

　　函数原型：BOOL ExtTextOut(HDC hdc, int X, int Y, UINT fuOptions, CONST RECT *lprc, LPCTSTR lpString, UINT cbCount, CONST INT *lpDx)；

　　参数：

　　hdc：设备环境句柄。

　　X：指定用于放置字符串的基准点的逻辑X坐标。

　　Y：指定用于放置字符串的基准Y坐标。

　　fuOptions：指定如何使用应用程序定义的矩形，此参数可为下列值的组合，各值含义为：

　　ETO_CLIPPED：正文将裁剪到矩形中。

　　ETO_GLYPH_INDEX：LpString指向由GetCharacterPlacement返回的数组，如果没有进一步的特殊语言处理的要求，则此数组直接由GDI解析，仅对字体应用符号索引，但此标志可用于位图和向量字体，以表示不必做进一步的语言处理，GDI应用直接处理此字符串。

　　ETO_OPAQUE：用当前的背景色来填充矩形。

　　ETO_RTLREADING：在Middle_Eastern Windows中如果指定了此值，且Hebrew或Arabic字体被选进设备环境，则此字符串用以从右到左的阅读顺序来输出。如果没有指定此值，则字符串以从左到右的顺序输出。在SetTextAlign中设置TA_RTLREADING值可获得同样的效果。为向后兼容，此值作为保留值。

　　ETO_GLYPH_INDEX和ETO_RTLREADING值不能在一起使用。因为ETO_GLYPH_INDEX表示所有的语言处理已经完成，函数就会忽略被指定的ETO_RTLREADING值。

　　注意，尽管对光栅字体而言，字符串被认为是8位值的数据，但所有的符号索引都是16位值。

　　lprc：指向结构RECT的指针，其中包含了用于裁剪或作不透明物矩形的尺寸。

　　lpString：指向将被绘制的字符串的指针，此字符串不必是以/0结束的，因为cbCount指定了其长度。

　　cbCount：指定字符串的字符数。

　　lpDx：指向可选数组的指针，其中数组里的值表示相邻字符单位开始处间距离。例如，lpDx逻辑单元分离了字符单元i和字符单元cell i+1的开始点。

　　返回值：如果字符串被绘制，返回值非零，如果函数调用失败，返回值是0。

　　Windows NT：若想获得更多错误信息，请调用GetLastError函数。

　　备注：指定设备环境的当前文本对齐方式设置决定了基准点如何用来安置正文。调用函数GetTextAlign可获得文本对齐方式的设置。调用SetTextAlign函数可改变文本对齐方式。

　　如果参数lpDx为NULL，则ExtTextOut使用字符之间的缺省间隔。字符单元的起始处和由lpDx指向的数组的内容都由逻辑单元给出。一个字符单元起始处被定义为字符单元的右上角。

　　缺省地，此函数不使用和改变当前的状态。但是当系统在指定的设备环境调用ExtTextOut应用程序可以调用SetTextAlign函数（设置其参数fMode为TA_UPDATECP）允许系统使用和改变当前状态。当此标志设置时，系统会在随后的ExtTextOut调用中忽略X、Y参数值。

　　Windows CE：支持fuOptions参数取下列值：ETO_CLIPPED, ETO_OPAQUE。

　　速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：wingdi.h；库文件：gdi32.lib；Unicode：在Windows NT环境下以Unicode和ANSI两种方式实现。

DrawText

编辑本段

函数功能

　　该函数在指定的矩形里写入格式化的正文，根据指定的方法对正文格式化（扩展的制表符，字符对齐、折行等）。 　　要指定额外的格式化选项，请使用 DrawTextEx函数。 　　

  

  

编辑本段

函数原型

　　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	截短不符合矩形的正文，并增加省略号。