GdiComment功能将注释从缓冲区复制到指定的增强格式的图元文件中。
BOOL GdiComment(
| HDC 【HDC】, | //处理设备上下文 |
| UINT 【CBSIZE】, | //文本缓冲区大小 |
| CONST BYTE 【*的lpData】 | //指向文本缓冲区的指针 |
| ); |
参数
【HDC】
标识增强型图元文件设备上下文。
【CBSIZE】
指定注释缓冲区的长度（以字节为单位）。
【的lpData】
指向包含注释的缓冲区。
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。
备注
评论可以包括任何类型的私人信息__，例如图片的来源和创建的日期。注释应以应用程序签名开头，后跟数据。
注释不应包含特定于应用程序或位置的数据。位置特定的数据指定记录的位置，并且不应该包括一个元文件，因为一个图元文件可能嵌入在另一个元文件中。
公众评论是以注释签名标识符GDICOMMENT_IDENTIFIER开头的评论。以下公众意见被定义为：
| 评论 | 描述 | ||||
| GDICOMMENT_WINDOWS_METAFILE | |||||
| GDICOMMENT_WINDOWS_METAFILE公共评论包含一个等同于增强格式的图元文件的Windows格式的图元文件。此注释仅由SetWinMetaFileBits函数编写。评论记录（如果给出）遵循ENHMETAHEADER图元文件记录。评论的格式如下： | |||||
DWORD ident; //这包含GDICOMMENT_IDENTIFIER。en
DWORD iComment; //这包含GDICOMMENT_WINDOWS_METAFILE。
DWORD nVersion; //这包含版本号
// Windows格式的图元文件。
DWORD nChecksum; //这是DWORD校验和的加法
//增强的图元文件校验和
//对于增强的元文件数据，包括
//此评论记录必须为零。
//否则，增强的图元文件已经被
//修改和Windows格式
//元文件不再有效。
DWORD fFlags; //这必须是零。
DWORD cbWinMetaFile; //这是大小，以字节为单位。的
//后面的Windows格式的元文件数据。
| GDICOMMENT_BEGINGROUP | |||
| GDICOMMENT_BEGINGROUP公共评论标识一组绘图记录的开头。它识别增强图元文件中的一个对象。评论的格式如下： | |||
DWORD ident; //这包含GDICOMMENT_IDENTIFIER。en
DWORD iComment; //这包含GDICOMMENT_BEGINGROUP。
RECTL rclOutput; //这是边框的边框
//逻辑坐标中的对象。
DWORD nDescription; //这是字符数
//可选的Unicode描述字符串
//如下如果没有，则为零
//描述字符串。
| GDICOMMENT_ENDGROUP | |||
| GDICOMMENT_ENDGROUP公开评论标识了一组绘图记录的结尾。GDICOMMENT_BEGINGROUP注释和GDICOMMENT_ENDGROUP注释必须包含在一对中，并可能嵌套。评论的格式如下： | |||
DWORD ident; //这包含GDICOMMENT_IDENTIFIER。en
DWORD iComment; //这包含GDICOMMENT_ENDGROUP。
| GDICOMMENT_MULTIFORMATS | |||
| GDICOMMENT_MULTIFORMATS公共评论允许将图片的多个定义包含在增强的图元文件中。例如，使用此注释，应用程序可以包括封装的PostScript定义以及图片的增强图元文件定义。当录制回放时，GDI会选择并呈现设备识别的第一种格式。评论的格式如下： | |||
DWORD ident; //这包含GDICOMMENT_IDENTIFIER。en
DWORD iComment; //这包含GDICOMMENT_MULTIFORMATS。
RECTL rclOutput; //这是边框的边框
//图片在逻辑坐标。
DWORD nFormats; //这里包含的格式数量
//评论。
EMRFORMAT aemrformat[1];//这是一个EMRFORMAT结构的数组
//按照优先顺序。数据
//每个格式跟随最后一个
// EMRFORMAT结构。
EMRFORMAT结构具有以下形式：
typedef struct tagEMRFORMAT {en
DWORD dSignature;
DWORD nVersion;
DWORD cbData;
DWORD offData;
} EMRFORMAT;
也可以看看
