GdiComment

GdiComment

VB声明

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

说明

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

返回值

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

参数表

参数

类型及说明

hdc

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

cbSize

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

lpData

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

注解

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

第一个条目是常数GDICOMMENT_IDENTIFIER

第二个条目如下所示：

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

□  标准图元文件的版本号

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

□  零

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

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

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

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

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

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

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

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

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

Top