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

GdipRecordMetafileFileName

Previous pageReturn to chapter overviewNext page

描述

 

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

 

C++ 语法

 

GpStatus WINGDIPAPI GdipRecordMetafileFileName(

   GDIPCONST WCHAR* fileName,

   HDC referenceHdc,

   EmfType type,

   GDIPCONST GpRectF * frameRect,

   MetafileFrameUnit frameUnit,

   GDIPCONST WCHAR * description,

  GpMetafile ** metafile

);

 

PowerBASIC 语法

 

FUNCTION GdipRecordMetafileFileName ( _

   BYREF filename AS WSTRINGZ _

   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

 

参数

 

filename

 

[in]指向指定保存图元文件的文件名称的宽字符串的指针。

 

referenceHdc

 

[in]包含显示设备属性的设备上下文的Windows句柄。

 

type

 

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

 

frameRect

 

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

 

frameUnit

 

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

 

description

 

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

 

metafile

 

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

 

返回值

 

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

 

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

 

备注

 

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