GdiComment 函数 (wingdi.h)

GdiComment 函数将注释从缓冲区复制到指定的增强格式图元文件。

语法

BOOL GdiComment(
  [in] HDC        hdc,
  [in] UINT       nSize,
  [in] const BYTE *lpData
);

参数

[in] hdc

增强型图元文件设备上下文的句柄。

[in] nSize

注释缓冲区的长度（以字节为单位）。

[in] lpData

指向包含注释的缓冲区的指针。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

注解

注释可以包含任何类型的私人信息，例如图片的源和创建日期。 注释应以应用程序签名开头，后跟数据。

注释不应包含特定于应用程序或特定于位置的数据。 特定于位置的数据指定记录的位置，并且不应包含它，因为一个图元文件可能嵌入另一个图元文件中。

公共评论是以注释签名标识符GDICOMMENT_IDENTIFIER开头的注释。 定义了以下公共注释。

GDICOMMENT_WINDOWS_METAFILE

GDICOMMENT_WINDOWS_METAFILE公共注释包含等效于增强格式图元文件的 Windows 格式图元文件。 此注释仅由 SetWinMetaFileBits 函数编写。 注释记录（如果给定）遵循 ENHMETAHEADER 图元文件记录。 注释具有以下形式：

 

DWORD ident;         // This contains GDICOMMENT_IDENTIFIER.  
DWORD iComment;      // This contains GDICOMMENT_WINDOWS_METAFILE.  
DWORD nVersion;      // This contains the version number of the  
                     // Windows-format metafile.  
DWORD nChecksum;     // This is the additive DWORD checksum for  
                     // the enhanced metafile.  The checksum  
                     // for the enhanced metafile data including  
                     // this comment record must be zero.  
                     // Otherwise, the enhanced metafile has been  
                     //  modified and the Windows-format  
                     // metafile is no longer valid.  
DWORD fFlags;        // This must be zero.  
DWORD cbWinMetaFile; // This is the size, in bytes. of the  
                     // Windows-format metafile data that follows.  

GDICOMMENT_BEGINGROUP

GDICOMMENT_BEGINGROUP公开注释标识一组绘图记录的开头。 它标识增强型图元文件中的对象。 注释具有以下形式：

 

DWORD   ident;         // This contains GDICOMMENT_IDENTIFIER.  
DWORD   iComment;      // This contains GDICOMMENT_BEGINGROUP.  
RECTL   rclOutput;     // This is the bounding rectangle for the  
                       // object in logical coordinates.  
DWORD   nDescription;  // This is the number of characters in the  
                       // optional Unicode description string that  
                       // follows. This is zero if there is no  
                       // description string.  

GDICOMMENT_ENDGROUP

GDICOMMENT_ENDGROUP公开注释标识一组绘图记录的末尾。 GDICOMMENT_BEGINGROUP注释和GDICOMMENT_ENDGROUP注释必须包含在对中，并且可以嵌套。 注释具有以下形式：

 

DWORD   ident;       // This contains GDICOMMENT_IDENTIFIER.  
DWORD   iComment;    // This contains GDICOMMENT_ENDGROUP.  

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll

另请参阅

CreateEnhMetaFile

图元文件函数

图元文件概述

SetWinMetaFileBits