描述
创建一个图元文件对象进行录制。
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 +必须能够获取该文件的排他锁。