Metafile::Metafile (IStream*,HDC,constRect&,MetafileFrameUnit,EmfType,constWCHAR*) 方法 (gdiplusheaders.h)

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

语法

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

参数

[in] stream

类型: IStream*

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

[in] referenceHdc

类型: HDC

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

[in, ref] frameRect

类型: const Rect

对限定图元文件显示边界的矩形的引用。

[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

图元文件

录制图元文件

Rect