Metafile.Metafile(HMETAFILE, const WmfPlaceableFileHeader*, BOOL) constructor

Applies to: desktop apps only

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

Syntax

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

Parameters

  • hWmf [in]
    Type: HMETAFILE

    Windows handle to a metafile.

  • wmfPlaceableFileHeader [in]
    Type: const WmfPlaceableFileHeader*

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

  • deleteWmf [in]
    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.

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

Minimum supported client

Windows XP, Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

GDI+ 1.0

Header

Gdiplusmetafile.h (include Gdiplus.h)

Library

Gdiplus.lib

DLL

Gdiplus.dll

See also

Metafile

PWMFRect16

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012