Metafile::Metafile(HMETAFILE,constWmfPlaceableFileHeader*,BOOL) method (gdiplusheaders.h)

Creates a Windows GDI+Metafile::Metafile object for recording. The format will be placeable metafile.

Syntax

void Metafile(
  [in] HMETAFILE                    hWmf,
  [in] const WmfPlaceableFileHeader *wmfPlaceableFileHeader,
  [in] BOOL                         deleteWmf
);

Parameters

[in] hWmf

Type: HMETAFILE

Windows handle to a metafile.

[in] wmfPlaceableFileHeader

Type: const WmfPlaceableFileHeader*

Pointer to a WmfPlaceableFileHeader structure that specifies a preheader preceding the metafile header.

[in] deleteWmf

Type: BOOL

Optional. BOOL value that specifies whether the Windows handle to a metafile is deleted when the metafile is deleted. TRUE specifies that the hWmf Windows handle is deleted, and FALSE specifies that the hWmf Windows handle is not deleted. The default value is FALSE.

Return value

None

Remarks

Placeable metafiles are WMF files that contain a preheader preceding the metafile header. The preheader contains additional information for the metafile header of the metafile.

Requirements

Requirement Value
Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusheaders.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See also

Metafile

PWMFRect16