GetEnhMetaFileDescription函数从增强格式的图元文件中检索可选文本描述,并将该字符串复制到指定的缓冲区。
UINT GetEnhMetaFileDescription(
HENHMETAFILE 【HEMF】, | //处理增强型图元文件 |
UINT 【cchBuffer】, | //文本缓冲区的大小,以字符为单位 |
LPTSTR 【XNUM】 | //文本缓冲区的地址 |
); |
参数
【HEMF】
识别增强的图元文件。
【cchBuffer】
指定接收数据的缓冲区的大小(以字符为单位)。只有这么多人物才会被复制。
【XNUM】
指向缓冲区以接收可选文本描述。
返回值
如果可选文本描述存在且缓冲区指针为NULL,则返回值为文本字符串的长度,以字符为单位。
如果可选文本描述存在且缓冲区指针是有效指针,则返回值是复制到缓冲区中的字符数。
如果可选文本描述不存在,返回值为零。
如果函数失败,返回值为GDI_ERROR。
备注
可选文本描述包含两个字符串,第一个标识创建增强型图元文件的应用程序,第二个标识图元文件中包含的图片。字符串由空字符分隔,并以两个空字符__终止,例如“XYZ Graphics Editor \\ 0Bald Eagle \\ 0 \\ 0”,其中\\ 0表示空字符。
在文本参数必须使用Unicode字符的地方,将此函数用作宽字符函数。如果文本参数必须使用Windows 3.【x】字符集中的字符,请使用此函数作为ANSI函数。
Windows 95:增强型图元文件的描述字符串的最大长度为16,384字节。
也可以看看