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で始まるコメントです。 次のパブリック コメントが定義されています。

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