Fungsi GdiComment (wingdi.h)

Artikel
03/13/2024

Fungsi GdiComment menyalin komentar dari buffer ke dalam metafile format yang ditingkatkan yang ditentukan.

Sintaks

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

Parameter

[in] hdc

Handel ke konteks perangkat metafile yang disempurnakan.

[in] nSize

Panjang buffer komentar, dalam byte.

[in] lpData

Penunjuk ke buffer yang berisi komentar.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Komentar dapat menyertakan segala jenis informasi privat, misalnya, sumber gambar dan tanggal pembuatannya. Komentar harus dimulai dengan tanda tangan aplikasi, diikuti oleh data.

Komentar tidak boleh berisi data khusus aplikasi atau posisi tertentu. Data khusus posisi menentukan lokasi rekaman, dan tidak boleh disertakan karena satu metafile dapat disematkan dalam metafile lain.

Komentar publik adalah komentar yang dimulai dengan pengidentifikasi tanda tangan komentar GDICOMMENT_IDENTIFIER. Komentar publik berikut didefinisikan.

GDICOMMENT_WINDOWS_METAFILE

Komentar publik GDICOMMENT_WINDOWS_METAFILE berisi metafile format Windows yang setara dengan metafile format yang disempurnakan. Komentar ini hanya ditulis oleh fungsi SetWinMetaFileBits . Catatan komentar, jika diberikan, mengikuti catatan metafile ENHMETAHEADER . Komentar memiliki formulir berikut:


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

Komentar publik GDICOMMENT_BEGINGROUP mengidentifikasi awal dari sekelompok rekaman gambar. Ini mengidentifikasi objek dalam metafile yang ditingkatkan. Komentar memiliki formulir berikut:


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

Komentar publik GDICOMMENT_ENDGROUP mengidentifikasi akhir dari sekelompok rekaman gambar. Komentar GDICOMMENT_BEGINGROUP dan komentar GDICOMMENT_ENDGROUP harus disertakan dalam sepasang dan dapat ditumpuk. Komentar memiliki formulir berikut:


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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

CreateEnhMetaFile

Fungsi Metafile

Gambaran Umum Metafiles

SetWinMetaFileBits

Bagikan melalui