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

Article
02/22/2024

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