Metafile::Metafile(constWCHAR,HDC,constRect&,MetafileFrameUnit,EmfType,constWCHAR)-Methode (gdiplusheaders.h)

Artikel
08/24/2023

Erstellt ein Metafile::Metafile-Objekt für die Aufzeichnung.

Syntax

void Metafile(
  [in]      const WCHAR       *fileName,
  [in]      HDC               referenceHdc,
  [in, ref] const Rect &      frameRect,
  [in]      MetafileFrameUnit frameUnit,
  [in]      EmfType           type,
  [in]      const WCHAR       *description
);

Parameter

[in] fileName

Typ: const WCHAR*

Zeiger auf eine Breitzeichenzeichenfolge, die den Namen der Datei angibt, in der die Metadatei gespeichert wird.

[in] referenceHdc

Typ: HDC

Verarbeiten eines Gerätekontexts, der Attribute eines Anzeigegeräts enthält.

[in, ref] frameRect

Typ: const Rect

Verweis auf ein Rechteck, das die Metadateianzeige eingrenzt.

[in] frameUnit

Typ: MetaFileFrameUnit

Optional. Element der MetafileFrameUnit-Enumeration , die die Maßeinheit für frameRect angibt. Der Standardwert ist MetafileFrameUnitGdi.

[in] type

Typ: EmfType

Optional. Element der EmfType-Enumeration , das den Typ der Metadatei angibt, die aufgezeichnet wird. Der Standardwert ist EmfTypeEmfPlusDual.

[in] description

Typ: const WCHAR*

Optional. Zeiger auf eine Breitzeichenzeichenfolge, die den beschreibenden Namen der Metadatei angibt. Der Standardwert ist NULL.

Rückgabewert

Keine

Bemerkungen

Beim Aufzeichnen in einer Datei muss die Datei beschreibbar sein, und Windows GDI+ muss in der Lage sein, eine exklusive Sperre für die Datei zu erhalten.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll