GdiComment-Funktion (wingdi.h)
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 |