CMetaFileDC::CreateEnhanced

项目
03/01/2013

创建引发格式图元文件的设备上下文。

BOOL CreateEnhanced(
   CDC* pDCRef,
   LPCTSTR lpszFileName,
   LPCRECT lpBounds,
   LPCTSTR lpszDescription 
);

参数

pDCRef
一个增强型图元文件的引用计算机。
lpszFileName
指向Null终止的字符串）。指定文件名必须将创建一个增强型图元文件。如果此参数是 NULL，该增强型图元文件存储基础，其内容丢失，当销毁对象时，或者当Win32 DeleteEnhMetaFile 函数调用时。
lpBounds
指向 RECT 数据结构或在 HIMETRIC 单元测试指定维的 CRect 对象(.01毫米递增。该增强型图元文件将存储)的图片。
lpszDescription
指向指定应用程序创建图片，以及图片的前缀的名称为零结尾的字符串。

返回值

设备上下文的处理增强型图元文件，则为;如果成功;否则 NULL。

备注

此DC可用于存储一个与设备无关的图片。

Windows使用 pDCRef 参数标识的引用设备记录图片最初显示设备的分辨率和单位。如果 pDCRef 参数是 NULL，它使用当前显示设备为引用。

RECT 数据结构的左侧和顶部成员指向由 lpBounds 参数小于右侧和底部成员必须，分别。沿矩形前边缘在图片点包括。如果 lpBounds 是 NULL，图形设备接口(GDI)计算可将应用程序绘制的图片最小矩形的尺寸。应尽可能提供 lpBounds 参数。

该字符串指向由 lpszDescription 参数必须包含应用程序名和图片名称之间的null字符，并且必须停止具有两个null字符—示例，“XYZ图形编辑器\ 0Bald老鹰\ 0 \ 0”，其中\ 0表示在null字符。如果 lpszDescription 是 NULL，则在引发图元文件标头的对应的项。

应用程序在一个增强型图元文件使用此功能创建的DC存储图像图片。标识此DC的句柄可传递给所有GDI功能。

在应用程序在一个增强型图元文件后存储图片，则可以通过调用 CDC::PlayMetaFile 函数显示在所有输出设备的图片。当显示图片时，Windows使用矩形指向由 lpBounds 参数和解析数据从引用设备确定和称为图片。此函数返回的设备上下文包含相同的默认特性与任何新的DC。

应用程序必须使用Win32 GetWinMetaFileBits 功能将一个增强型图元文件转换为旧的Windows图元文件格式。

该增强型图元文件的文件名应使用.EMF扩展。