描述
CreateMetaFile功能为Windows格式的图元文件创建一个设备上下文。
注意此函数仅用于与Windows格式的图元文件兼容。增强格式的图元文件提供卓越的功能，并推荐用于新的应用程序。增强格式图元文件的相应功能是CreateEnhMetaFile.
C++ 语法
HDC CreateMetaFile( __in LPCTSTR lpszFile ); |
PowerBASIC 语法
FUNCTION CreateMetaFileA ( _ BYREF lpszFile AS ASCIIZ _ ) AS DWORD |
Unicode版本:
FUNCTION CreateMetaFileW ( _ BYREF lpszFile AS WSTRINGZ _ ) AS DWORD |
参数
lpszFile
[in]指向要创建的Windows格式图元文件的文件名的指针。如果此参数为NULL，Windows格式的图元文件是基于内存的，并且使用DeleteMetaFile功能删除时，其内容将丢失。
返回值
如果函数成功，则返回值是Windows格式元文件的设备上下文的句柄。
如果函数失败，返回值为NULL。
备注
在文本参数必须使用Unicode字符的地方，使用CreateMetaFile功能作为宽字符功能。如果文本参数必须使用Windows字符集中的字符，请使用此函数作为ANSI函数。
CreateMetaFile是Windows格式的图元文件功能。此函数仅支持16位基于Windows的应用程序，这些应用程序列在Windows格式的图元文件中。它不记录或播放不属于16位Windows的GDI功能，例如PolyBezier.
由此函数创建的设备上下文可用于在Windows格式的图元文件中记录GDI输出功能。它不能与GDI查询功能（如GetTextColor）一起使用。当设备上下文与GDI输出功能一起使用时，如果函数被记录，则该函数的返回值为TRUE，否则返回FALSE。通过使用SelectObject功能选择对象时，只会记录对象的副本。对象仍然属于应用程序。
要创建可扩展的Windows格式的图元文件，请以MM_ANISOTROPIC映射模式记录图形输出。该文件不能包含修改视口原点和扩展区的函数，也不能包含与设备相关的功能，例如SelectClipRgn功能。创建后，Windows图元文件可以通过在播放之前定义视口原点和图像范围，将其缩放并呈现为任何输出设备格式。
Windows 95/98 / Me：Microsoft Layer for Unicode支持CreateMetaFileW.
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）