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)
程式庫	Gdi32.lib
Dll	Gdi32.dll

另請參閱

CreateEnhMetaFile

元檔函式

元檔概觀

SetWinMetaFileBits