ENHMETAHEADER-Struktur (wingdi.h)

Die ENHMETAHEADER-Struktur enthält erweiterte Metadatendaten, z. B. die Abmessungen des in der erweiterten Metadatei gespeicherten Bilds, die Anzahl der Datensätze in der erweiterten Metadatei, die Auflösung des Geräts, auf dem das Bild erstellt wurde usw.

Diese Struktur ist immer der erste Datensatz in einer erweiterten Metadatei.

Syntax

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;

Member

iType

Der Datensatztyp. Dieser Member muss den Wert angeben, der der EMR_HEADER-Konstanten zugewiesen ist.

nSize

Die Strukturgröße in Bytes.

rclBounds

Die Abmessungen des kleinsten Rechtecks in Geräteeinheiten, das um das in der Metadatei gespeicherte Bild gezeichnet werden kann. Dieses Rechteck wird von der Grafikgeräteschnittstelle (Graphics Device Interface, GDI) bereitgestellt. Seine Abmessungen umfassen den rechten und unteren Rand.

rclFrame

Die Abmessungen eines Rechtecks in 0,01 Millimetereinheiten, das das in der Metadatei gespeicherte Bild umgibt. Dieses Rechteck muss von der Anwendung bereitgestellt werden, die die Metadatei erstellt. Seine Abmessungen umfassen den rechten und unteren Rand.

dSignature

Eine Signatur. Dieser Member muss den Wert angeben, der der ENHMETA_SIGNATURE-Konstanten zugewiesen ist.

nVersion

Die Metadateiversion. Der aktuelle Versionswert ist 0x10000.

nBytes

Die Größe der erweiterten Metadatei in Bytes.

nRecords

Die Anzahl der Datensätze in der erweiterten Metadatei.

nHandles

Die Anzahl der Handles in der Handletabelle enhanced-metafile. (Index null in dieser Tabelle ist reserviert.)

sReserved

Reserviert; muss null sein.

nDescription

Die Anzahl der Zeichen im Array, das die Beschreibung des Inhalts der erweiterten Metadatei enthält. Dieser Member sollte auf null festgelegt werden, wenn die erweiterte Metadatei keine Beschreibungszeichenfolge enthält.

offDescription

Der Offset vom Anfang der ENHMETAHEADER-Struktur bis zum Array, das die Beschreibung des Inhalts der erweiterten Metadatei enthält. Dieser Member sollte auf null festgelegt werden, wenn die erweiterte Metadatei keine Beschreibungszeichenfolge enthält.

nPalEntries

Die Anzahl der Einträge in der Palette der erweiterten Metadatei.

szlDevice

Die Auflösung des Referenzgeräts in Pixel.

szlMillimeters

Die Auflösung des Referenzgeräts in Millimetern.

cbPixelFormat

Die Größe des letzten aufgezeichneten Pixelformats in einer Metadatei. Wenn in einem Referenz-DC am Anfang der Aufzeichnung ein Pixelformat festgelegt wird, wird cbPixelFormat auf die Größe des PIXELFORMATDESCRIPTOR festgelegt. Wenn kein Pixelformat festgelegt ist, wenn eine Metadatei aufgezeichnet wird, wird dieses Element auf 0 (null) festgelegt. Wenn mehr als ein einzelnes Pixelformat festgelegt ist, zeigt die Kopfzeile auf das letzte Pixelformat.

offPixelFormat

Der Offset des Pixelformats, das beim Aufzeichnen einer Metadatei verwendet wird. Wenn ein Pixelformat in einem Referenz-DC zu Beginn der Aufzeichnung oder während der Aufzeichnung festgelegt wird, wird offPixelFormat in der Metadatei auf den Offset des PIXELFORMATDESCRIPTOR festgelegt. Wenn beim Erfassen einer Metadatei kein Pixelformat festgelegt wird, wird dieses Element auf 0 (null) festgelegt. Wenn mehr als ein einzelnes Pixelformat festgelegt ist, zeigt die Kopfzeile auf das letzte Pixelformat.

bOpenGL

Gibt an, ob OpenGL-Einträge in einer Metadatei vorhanden sind. bOpenGL ist ein einfaches boolesches Flag, mit dem Sie bestimmen können, ob eine erweiterte Metadatei eine OpenGL-Behandlung erfordert. Wenn eine Metadatei OpenGL-Einträge enthält, ist bOpenGLTRUE; Andernfalls ist es FALSE.

szlMicrometers

Die Größe des Referenzgeräts in Mikrometern.

Anforderungen

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

Weitere Informationen

ENHMETARECORD

Metadateistrukturen

Übersicht über Metadateien

RECTL