gdicomment

［声明］

Declare Function GdiComment Lib "gdi32" Alias "GdiComment" (ByVal hdc As Long, ByVal cbSize As Long, lpData As Byte) As Long

［说明］

为指定的增强型图元文件设备场景添加一条注释信息

［参数表］

hdc ------------ Long，目标增强型图元文件设备场景的句柄

cbSize --------- Long，欲嵌入图元文件的数据长度

lpData --------- Byte，一个注释结构或一个缓冲区的Long内存地址，其中包含了欲添加的注释正文

［返回值］

Long，非零表示成功，零表示失败

［其它］

尽管可在图元文件中嵌入任何专用或私有（Private）信息，但只有几种全局数据格式能够嵌入。如将缓冲区看作一个32位Long型值的数组，则全局注释的值就是下面这个样子：

第一个条目是常数GDICOMMENT_IDENTIFIER

第二个条目如下所示：

首先是一个GDICOMMENT_WINDOWS_METAFILE——在增强型图元文件中嵌入一个标准图元文件。它的后面跟随下述值之一：

□ 标准图元文件的版本号

□ 一个校验和（checksum）值：所有图元文件数据的总和——包括这个值——必须是零

□ 零

□ 后面跟随的窗口图元文件的大小

GDICOMMENT_BEGINGROUP——标志一组绘图命令在增强型图元文件在中的起始处。它的后面跟随：

□ 四个Long值。定义一个RECT结构。结构中包含了绘图命令的约束矩形

□ 可选的Unicode字串的长度。字串中包含对命令组的说明文字。如不想提供说明，可设为零

GDICOMMENT_ENDGROUP——标志增强型图元文件中的一组绘图命令的结尾

GDICOMMENT_MULTIFORMATS——以不同的格式嵌入一幅处理过的图象。例如，可利用这个注释在一个增强型图元文件中嵌入一个封装式PostScript图象。回放这条记录的时候，windows会重画它能描绘的第一组格式。它的后面跟随：

□ 四个Long值。定义一个RECT结构。结构中包含了绘图命令的约束矩形

□ 包括在注释中的格式数量

□ 一系列EMRFORMAT结构，每种格式使用一个