描述
创建一个图元文件对象进行录制。
C++ 语法
GpStatus WINGDIPAPI GdipRecordMetafileFileNameI( GDIPCONST WCHAR* fileName, HDC referenceHdc, EmfType type, GDIPCONST GpRect * frameRect, MetafileFrameUnit frameUnit, GDIPCONST WCHAR * description, GpMetafile ** metafile ); |
PowerBASIC 语法
FUNCTION GdipRecordMetafileFileNameI ( _ BYREF filename AS WSTRINGZ, _ BYVAL referenceHdc AS DWORD, _ BYVAL pType AS LONG, _ BYREF frameRect AS RECTL, _ 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 +必须能够获取该文件的排他锁。