GdiComment 関数 (wingdi.h)

GdiComment 関数は、バッファーから指定された拡張形式のメタファイルにコメントをコピーします。

構文

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

パラメーター

[in] hdc

拡張メタファイル デバイス コンテキストへのハンドル。

[in] nSize

コメント バッファーの長さ (バイト単位)。

[in] lpData

コメントを含むバッファーへのポインター。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

注釈

コメントには、写真のソースや作成日など、あらゆる種類の個人情報を含めることができます。 コメントはアプリケーション署名で始まり、その後にデータが続く必要があります。

コメントには、アプリケーション固有のデータや位置固有のデータを含めないようにしてください。 位置固有のデータはレコードの場所を指定します。1 つのメタファイルが別のメタファイルに埋め込まれる可能性があるため、含めないようにする必要があります。

パブリック コメントは、コメント署名識別子GDICOMMENT_IDENTIFIERで始まるコメントです。 次のパブリック コメントが定義されています。

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.  

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.  

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

要件

こちらもご覧ください

CreateEnhMetaFile

メタファイル関数

メタファイルの概要

SetWinMetaFileBits