描述
CreateEnhMetaFile功能为增强格式的图元文件创建一个设备上下文。该设备上下文可用于存储与设备无关的图片。
C++ 语法
HDC CreateEnhMetaFile( __in HDC hdcRef, __in LPCTSTR lpFilename, __in const RECT *lpRect, __in LPCTSTR lpDescription ); |
PowerBASIC 语法
FUNCTION CreateEnhMetaFileA ( _ BYVAL hdcRef AS DWORD, _ BYREF lpFilename AS ASCIIZ, _ BYREF lpRect AS RECT, _ BYREF lpDescription AS ASCIIZ _ ) AS DWORD |
Unicode版本:
FUNCTION CreateEnhMetaFileW ( _ BYVAL hdcRef AS DWORD, _ BYREF lpFilename AS WSTRINGZ, _ BYREF lpRect AS RECT, _ BYREF lpDescription AS WSTRINGZ _ ) AS DWORD |
参数
hdcRef
[in]处理增强型元文件的参考设备。
lpFileName
[in]指向要创建的增强型图元文件的文件名的指针。如果此参数为NULL，则增强型图元文件是基于内存的，并且通过使用DeleteEnhMetaFile功能将其内容丢失。
lpRect
[in]指向RECT结构的指针，指定要存储在增强型图元文件中的图片的尺寸（以.01毫米为单位）。
lpFileName
[in]指向指定创建图片的应用程序的名称以及图片标题的字符串的指针。
返回值
如果函数成功，则返回值是增强图元文件的设备上下文的句柄。
如果函数失败，返回值为NULL。
备注
在文本参数必须使用Unicode字符的地方，使用CreateEnhMetaFile功能作为宽字符功能。如果文本参数必须使用Windows字符集中的字符，请使用此函数作为ANSI函数。
系统使用由hdcRef参数标识的参考设备来记录最初出现照片的设备的分辨率和单位。如果hdcRef参数为NULL，则使用当前显示设备进行参考。
LPRECT参数指向的RECT结构的左侧和顶部成员必须分别小于右侧和底部成员。沿着矩形边缘的点包括在图片中。如果LPRECT为NULL，则图形设备接口（GDI）计算由应用程序绘制的图片围绕的最小矩形的尺寸。应尽可能提供LPRECT参数。
lpDescription参数指向的字符串必须在应用程序名称和图片名称之间包含一个空字符，并且必须以两个空字符终止，例如“XYZ Graphics Editor \\ 0Bald Eagle \\ 0 \\ 0”，其中\\ 0表示空字符如果lpDescription为NULL，则增强型图元文件头中没有相应的条目。
应用程序使用此函数创建的设备上下文将图形图像存储在增强型图元文件中。识别此设备上下文的句柄可以传递给任何GDI函数。
应用程序将图片存储在增强型图元文件中后，可以通过调用PlayEnhMetaFile功能在任何输出设备上显示图像。当显示图像时，系统使用LPRECT参数指向的矩形和来自参考设备的分辨率数据来定位和缩放图像。
此函数返回的设备上下文包含与任何新设备上下文相关的默认属性。
应用程序必须使用GetWinMetaFileBits函数将增强型图元文件转换为较旧的Windows图元文件格式。
增强型图元文件的文件名应使用.emf扩展名。
Windows 95/98 / Me：Microsoft Layer for Unicode支持CreateEnhMetaFileW.
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）