Metafile.Metafile(const WCHAR*, HDC, const Rect, MetaFileFrameUnit, EmfType, const WCHAR*) constructor

Applies to: desktop apps only

Creates a Metafile::Metafile object for recording.

Syntax

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

Parameters

  • fileName [in]
    Type: const WCHAR*

    Pointer to a wide-character string that specifies the name of the file in which the metafile will be saved.

  • referenceHdc [in]
    Type: HDC

    Handle to a device context that contains attributes of a display device.

  • frameRect [in, ref]
    Type: const Rect

    Reference to a rectangle that bounds the metafile display.

  • frameUnit [in]
    Type: MetaFileFrameUnit

    Optional. Element of the MetafileFrameUnit enumeration that specifies the unit of measure for frameRect. The default value is MetafileFrameUnitGdi.

  • type [in]
    Type: EmfType

    Optional. Element of the EmfType enumeration that specifies the type of metafile that will be recorded. The default value is EmfTypeEmfPlusDual.

  • description [in]
    Type: const WCHAR*

    Optional. Pointer to a wide-character string that specifies the descriptive name of the metafile. The default value is NULL.

Remarks

When recording to a file, the file must be writable, and Windows GDI+ must be able to obtain an exclusive lock on the file.

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

EmfType

MetafileFrameUnit

Rect

Loading and Displaying Metafiles

Recording Metafiles

Metafiles

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012