图元文件::Metafile (IStream*,HDC,constRectF&,MetafileFrameUnit,EmfType,constWCHAR*) 方法 (gdiplusheaders.h)

创建用于录制到 IStream 接口的 Metafile::Metafile 对象。

语法

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

参数

[in] stream

类型: IStream*

指向指向文件中数据流的 COM IStream 接口的指针。 记录命令后,它们将保存到此流中。

[in] referenceHdc

类型: HDC

设备上下文的 Windows 句柄,其中包含用于记录图元文件的显示设备的属性。

[in, ref] frameRect

类型: const RectF

对绑定图元文件显示的矩形的引用。

[in] frameUnit

类型: MetafileFrameUnit

可选。 MetafileFrameUnit 枚举的元素,该元素指定 frameRect 的度量单位。 默认值为 MetafileFrameUnitGdi

[in] type

类型: EmfType

可选。 EmfType 枚举的元素,用于指定要记录的图元文件类型。 默认值为 EmfTypeEmfPlusDual

[in] description

类型: const WCHAR*

可选。 指向宽字符字符串的指针,该字符串指定图元文件的描述性名称。 默认值为 NULL。

返回值

备注

录制到文件时,该文件必须是可写的,并且 Windows GDI+ 必须能够获取该文件的独占锁。

要求

要求
最低受支持的客户端 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 gdiplusheaders.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

EmfType

加载和显示图元文件

Metafile

MetafileFrameUnit

图元文件

录制图元文件

RectF