勇芳软件工作室.汉化:  GDI+ Flat API > Graphics Functions >

GdipRecordMetafile

Previous pageReturn to chapter overviewNext page

描述

 

创建一个图元文件对象进行录制。

 

C++ 语法

 

GpStatus WINGDIPAPI GdipRecordMetafile(

   HDC referenceHdc,

   EmfType type,

   GDIPCONST GpRectF * frameRect,

   MetafileFrameUnit frameUnit,

   GDIPCONST WCHAR * description,

   GpMetafile ** metafile

);

 

PowerBASIC 语法

 

FUNCTION GdipRecordMetafile ( _

   BYVAL referenceHdc AS DWORD, _

   BYVAL pType AS LONG, _

   BYREF frameRect AS RECTF, _

   BYVAL frameUnit AS LONG, _

   BYREF description AS WSTRINGZ, _

   BYREF metafile AS DWORD _

) AS LONG

 

参数

 

referenceHdc

 

[in]包含用于记录图元文件的显示设备的属性的设备上下文的Windows句柄。

 

type

 

[in]EmfType枚举的元素,用于指定要记录的元文件的类型。默认值为EmfTypeEmfPlusDual.

 

frameRect

 

[in]引用限制图元文件显示的矩形。

 

frameUnit

 

[in]MetafileFrameUnit枚举的元素,用于指定frameRect的度量单位。默认值为MetafileFrameUnitGdi.

 

description

 

[in]指向指定元文件的描述性名称的宽字符串的指针。默认值为NULL。

 

metafile

 

[out]指向接收指向新创建的图元文件对象的指针的变量的指针。

 

返回值

 

如果函数成功,则返回Ok,它是状态枚举的一个元素。

 

如果函数失败,它返回状态枚举的其他元素之一。

 

备注

 

当记录到文件时,该文件必须是可写的,并且GDI +必须能够获取该文件的排他锁。