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) |