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结构 每种格式使用一个