Struttura ENHMETAHEADER (wingdi.h)

La struttura ENHMETAHEADER contiene dati metafile avanzati, ad esempio le dimensioni dell'immagine archiviate nel metafile avanzato, il numero di record nel metafile avanzato, la risoluzione del dispositivo in cui è stata creata l'immagine e così via.

Questa struttura è sempre il primo record in un metafile avanzato.

Sintassi

typedef struct tagENHMETAHEADER {
  DWORD iType;
  DWORD nSize;
  RECTL rclBounds;
  RECTL rclFrame;
  DWORD dSignature;
  DWORD nVersion;
  DWORD nBytes;
  DWORD nRecords;
  WORD  nHandles;
  WORD  sReserved;
  DWORD nDescription;
  DWORD offDescription;
  DWORD nPalEntries;
  SIZEL szlDevice;
  SIZEL szlMillimeters;
  DWORD cbPixelFormat;
  DWORD offPixelFormat;
  DWORD bOpenGL;
  SIZEL szlMicrometers;
} ENHMETAHEADER, *PENHMETAHEADER, *LPENHMETAHEADER;

Members

iType

Tipo di record. Questo membro deve specificare il valore assegnato alla costante EMR_HEADER.

nSize

Dimensioni della struttura, in byte.

rclBounds

Dimensioni, in unità di dispositivo, del rettangolo più piccolo che può essere disegnato intorno all'immagine archiviata nel metafile. Questo rettangolo viene fornito dall'interfaccia GDI (Graphics Device Interface). Le dimensioni includono i bordi destro e inferiore.

rclFrame

Dimensioni, in unità di 01 millimetri, di un rettangolo che circonda l'immagine archiviata nel metafile. Questo rettangolo deve essere fornito dall'applicazione che crea il metafile. Le dimensioni includono i bordi destro e inferiore.

dSignature

Firma. Questo membro deve specificare il valore assegnato alla costante ENHMETA_SIGNATURE.

nVersion

Versione del metafile. Il valore della versione corrente è 0x10000.

nBytes

Dimensioni in byte del metafile avanzato.

nRecords

Numero di record nel metafile avanzato.

nHandles

Numero di handle nella tabella handle enhanced-metafile. L'indice zero in questa tabella è riservato.

sReserved

Riservati; deve essere zero.

nDescription

Numero di caratteri nella matrice che contiene la descrizione del contenuto del metafile avanzato. Questo membro deve essere impostato su zero se il metafile avanzato non contiene una stringa di descrizione.

offDescription

Offset dall'inizio della struttura ENHMETAHEADER alla matrice contenente la descrizione del contenuto del metafile avanzato. Questo membro deve essere impostato su zero se il metafile avanzato non contiene una stringa di descrizione.

nPalEntries

Numero di voci nella tavolozza dei metafile avanzati.

szlDevice

Risoluzione del dispositivo di riferimento, in pixel.

szlMillimeters

Risoluzione del dispositivo di riferimento, in millimetri.

cbPixelFormat

Dimensioni dell'ultimo formato pixel registrato in un metafile. Se un formato pixel viene impostato in un controller di dominio di riferimento all'inizio della registrazione, cbPixelFormat viene impostato sulle dimensioni di PIXELFORMATDESCRIPTOR. Quando non viene impostato alcun formato pixel quando viene registrato un metafile, questo membro viene impostato su zero. Se è impostato più di un singolo formato pixel, l'intestazione punta all'ultimo formato pixel.

offPixelFormat

Offset del formato pixel utilizzato durante la registrazione di un metafile. Se un formato pixel viene impostato in un controller di dominio di riferimento all'inizio della registrazione o durante la registrazione, offPixelFormat viene impostato sull'offset di PIXELFORMATDESCRIPTOR nel metafile. Se non viene impostato alcun formato pixel quando viene registrato un metafile, questo membro viene impostato su zero. Se è impostato più di un singolo formato pixel, l'intestazione punta all'ultimo formato pixel.

bOpenGL

Indica se i record OpenGL sono presenti in un metafile. bOpenGL è un flag booleano semplice che è possibile usare per determinare se un metafile avanzato richiede la gestione OpenGL. Quando un metafile contiene record OpenGL, bOpenGL è TRUE; in caso contrario, è FALSE.

szlMicrometers

Dimensioni del dispositivo di riferimento, in micrometri.

Requisiti

Vedi anche

ENHMETARECORD

Strutture di metafile

Panoramica dei metafile

RECTL