GdiComment-Funktion (wingdi.h)

Artikel
08/27/2023

Die GdiComment-Funktion kopiert einen Kommentar aus einem Puffer in eine angegebene Metadatei im erweiterten Format.

Syntax

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

Parameter

[in] hdc

Ein Handle für einen Erweitert-Metafile-Gerätekontext.

[in] nSize

Die Länge des Kommentarpuffers in Bytes.

[in] lpData

Ein Zeiger auf den Puffer, der den Kommentar enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Ein Kommentar kann jede Art von privaten Informationen enthalten, z. B. die Quelle eines Bilds und das Datum der Erstellung. Ein Kommentar sollte mit einer Anwendungssignatur beginnen, gefolgt von den Daten.

Kommentare dürfen keine anwendungsspezifischen oder positionsspezifischen Daten enthalten. Positionsspezifische Daten geben den Speicherort eines Datensatzes an und sollten nicht eingeschlossen werden, da eine Metadatei möglicherweise in eine andere Metadatei eingebettet ist.

Ein öffentlicher Kommentar ist ein Kommentar, der mit dem Bezeichner der Kommentarsignatur beginnt GDICOMMENT_IDENTIFIER. Die folgenden öffentlichen Kommentare sind definiert.

GDICOMMENT_WINDOWS_METAFILE

Der GDICOMMENT_WINDOWS_METAFILE öffentlichen Kommentar enthält eine Metadatei im Windows-Format, die einer Metadatei im erweiterten Format entspricht. Dieser Kommentar wird nur von der SetWinMetaFileBits-Funktion geschrieben. Der Kommentardatensatz folgt, sofern angegeben, dem ENHMETAHEADER-Metadateidatensatz . Der Kommentar hat die folgende Form:


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

Der GDICOMMENT_BEGINGROUP öffentlichen Kommentar identifiziert den Anfang einer Gruppe von Zeichnungsdatensätzen. Es identifiziert ein Objekt in einer erweiterten Metadatei. Der Kommentar hat die folgende Form:


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

Der GDICOMMENT_ENDGROUP öffentlichen Kommentar identifiziert das Ende einer Gruppe von Zeichnungsdatensätzen. Der GDICOMMENT_BEGINGROUP Kommentar und der GDICOMMENT_ENDGROUP Kommentar müssen in einem Paar enthalten sein und können geschachtelt sein. Der Kommentar hat die folgende Form:


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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

CreateEnhMetaFile

Metafilefunktionen

Übersicht über Metadateien

SetWinMetaFileBits

Share via