Funzione GdiComment (wingdi.h)
La funzione GdiComment copia un commento da un buffer in un metafile in formato avanzato specificato.
Sintassi
BOOL GdiComment(
[in] HDC hdc,
[in] UINT nSize,
[in] const BYTE *lpData
);
Parametri
[in] hdc
Handle per un contesto di dispositivo metafile avanzato.
[in] nSize
Lunghezza del buffer dei commenti, in byte.
[in] lpData
Puntatore al buffer che contiene il commento.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Un commento può includere qualsiasi tipo di informazioni private, ad esempio l'origine di un'immagine e la data di creazione. Un commento deve iniziare con una firma dell'applicazione, seguita dai dati.
I commenti non devono contenere dati specifici dell'applicazione o specifici della posizione. I dati specifici della posizione specificano la posizione di un record e non devono essere inclusi perché un metafile può essere incorporato all'interno di un altro metafile.
Un commento pubblico è un commento che inizia con l'identificatore della firma del commento GDICOMMENT_IDENTIFIER. Vengono definiti i commenti pubblici seguenti.
| GDICOMMENT_WINDOWS_METAFILE | Il commento pubblico GDICOMMENT_WINDOWS_METAFILE contiene un metafile in formato Windows equivalente a un metafile in formato avanzato. Questo commento viene scritto solo dalla funzione SetWinMetaFileBits . Il record di commento, se specificato, segue il record metafile ENHMETAHEADER . Il commento ha il formato seguente: |
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 | Il commento pubblico GDICOMMENT_BEGINGROUP identifica l'inizio di un gruppo di record di disegno. Identifica un oggetto all'interno di un metafile avanzato. Il commento ha il formato seguente: |
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 | Il commento pubblico GDICOMMENT_ENDGROUP identifica la fine di un gruppo di record di disegno. Il commento GDICOMMENT_BEGINGROUP e il commento GDICOMMENT_ENDGROUP devono essere inclusi in una coppia e possono essere annidati. Il commento ha il formato seguente: |
DWORD ident; // This contains GDICOMMENT_IDENTIFIER.
DWORD iComment; // This contains GDICOMMENT_ENDGROUP.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |