CMetaFileDC::CreateEnhanced

BOOL CreateEnhanced ( CDC * pDCRef, LPCTSTR LpszFileName, LPCRECT LpBounds, LPCTSTR LpszDescription );

Rückgabewert

Ein Handle für den Gerätekontext für die erweiterte Metadatei, wenn erfolgreich; andernfalls NULL.

Parameter

pDCRef

Identifiziert ein Verweis-Gerät für die erweiterte Metadatei.

lpszFileName

Verweist auf eine Null-terminierte Zeichenfolge. Gibt den Dateinamen für die erweiterte Metafile erstellt werden soll. Wenn dieser Parameter NULList, ist die erweiterte Metadatei Basis und seinen Inhalt verloren, wenn das Objekt zerstört wird oder wenn die :: DeleteEnhMetaFile Funktion.

lpBounds

Verweist auf eine RECT -Datenstruktur oder ein CRect -Objekt, das angibt, die Dimensionen in HIMETRIC -Einheiten (in Schritten von.01-Millimeter) des Bildes in die erweiterte Metadatei gespeichert werden.

lpszDescription

Verweist auf eine mit NULL abgeschlossene Zeichenfolge, die den Namen der Anwendung, die das Bild sowie die Bild-Titel erstellt.

Bemerkungen

Erstellt einen Gerätekontext für eine enhanced-Format Metafile. Diese DC kann verwendet werden, um eine geräteunabhängige Bild speichern.

Windows verwendet das Verweis-Gerät durch den pDCRef -Parameter angegebenen aufzeichnen die Auflösung und die Einheiten des Geräts auf dem ursprünglich ein Bild erschien. Wenn der pDCRef -Parameter NULList, verwendet es das aktuellen Anzeigegerät für Verweis.

Die linke und obere die RECT -Datenstruktur mit den LpBounds -Parameter verwiesen muss kleiner als der Rechte und untere Mitglieder, jeweils angehören. Punkte entlang der Ränder des Rechtecks sind in dem Bild enthalten. Wenn LpBounds NULList, berechnet die Graphics Device Interface (GDI) die Abmessungen des kleinsten Rechtecks, die das Bild gezeichnet von der Anwendung einschließen können. Der LpBounds -Parameter bereitgestellt werden sollten, soweit möglich.

Die Zeichenfolge, auf die der LpszDescription -Parameter muss ein Null-Zeichen zwischen den Anwendungsnamen und den Bild-Namen enthalten und muss mit zwei Null-Zeichen enden – z. B. "XYZ Grafik Editor\0Bald Eagle\0\0," wobei \0, das Null-Zeichen darstellt. Wenn LpszDescription NULList, gibt es keinen entsprechenden Eintrag in der enhanced Metafile-header.

Anwendungen verwenden den DC von dieser Funktion erstellt eine Grafik Bild in eine erweiterte Metadatei speichern. Das Ermittlung dieser DC Handle kann an jede GDI-Funktion übergeben werden.

Nachdem eine Anwendung ein Bild in eine erweiterte Metadatei gespeichert werden, kann es das Bild auf jedem Ausgabegerät anzeigen, durch Aufrufen der CDC::PlayMetaFile -Funktion. Wenn das Bild angezeigt werden, verwendet Windows das Rechteck auf der LpBounds -Parameter und die Auflösung Daten vom Referenz-Gerät verweist zu positionieren und Skalieren das Bild. Der von dieser Funktion zurückgegebenen Gerätekontext enthält die gleichen Standardattribute verbunden mit jedem neuen DC.

Anwendungen müssen die :: GetWinMetaFileBits Funktion, um eine erweiterte Metadatei in den älteren Windows-Metafile-Format konvertieren.

Der Dateiname für die erweiterte Metadatei sollten verwenden die.EMF-Erweiterung.

Übersicht über die CMetaFileDCMember der Klasse | Hierarchiediagramm

See Also   CMetaFileDC::CloseEnhanced, CDC::PlayMetaFile, ::CloseEnhMetaFile, ::DeleteEnhMetaFile, ::GetEnhMetaFileDescription, ::GetEnhMetaFileHeader, ::GetWinMetaFileBits, ::PlayEnhMetaFile

Index