Funzione GetEnhMetaFileHeader (wingdi.h)

La funzione GetEnhMetaFileHeader recupera il record contenente l'intestazione per il metafile in formato avanzato specificato.

Sintassi

UINT GetEnhMetaFileHeader(
  [in]  HENHMETAFILE    hemf,
  [in]  UINT            nSize,
  [out] LPENHMETAHEADER lpEnhMetaHeader
);

Parametri

[in] hemf

Handle per il metafile avanzato per il quale deve essere recuperata l'intestazione.

[in] nSize

Dimensione, in byte, del buffer per ricevere i dati. Solo questo numero di byte verrà copiato.

[out] lpEnhMetaHeader

Puntatore a una struttura ENHMETAHEADER che riceve il record di intestazione. Se questo parametro è NULL, la funzione restituisce le dimensioni del record di intestazione.

Valore restituito

Se la funzione ha esito positivo e il puntatore della struttura è NULL, il valore restituito è la dimensione del record che contiene l'intestazione; se il puntatore alla struttura è un puntatore valido, il valore restituito corrisponde al numero di byte copiati. In caso contrario, è zero.

Commenti

Un'intestazione metafile avanzata contiene informazioni quali le dimensioni del metafile, in byte; le dimensioni dell'immagine archiviate nel metafile; il numero di record archiviati nel metafile; offset alla descrizione del testo facoltativo; le dimensioni della tavolozza facoltativa e la risoluzione del dispositivo in cui è stata creata l'immagine.

Il record che contiene l'intestazione enhanced-metafile è sempre il primo record nel metafile.

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

Vedi anche

ENHMETAHEADER

Funzioni metafile

Panoramica dei metafile

PlayEnhMetaFile