CreateEnhMetaFile

CreateEnhMetaFile

VB声明

Declare Function CreateEnhMetaFile Lib "gdi32" Alias "CreateEnhMetaFileA" (ByVal hdcRef As Long, ByVal lpFileName As String, lpRect As RECT, ByVal lpDescription As String) As Long

说明

创建一个增强型的图元文件设备场景。绘图操作也许在这个设备场景中执行。调用CloseEnhMetaFile函数关闭了这个设备场景后,会创建一个图元文件句柄,在其中包含记录下来的绘图命令序列。随后,可在任何设备场景中回放这些命令

返回值

Long,一个增强型图元文件设备场景。零表示函数执行出错。不要将这个设备场景与图元文件句柄混淆起来。图元文件设备场景用于描绘图元文件——这与GDI绘图函数作为参数使用的其他任何设备场景是一样的。调用CloseEnhMetaFile函数的时候,会获得实际的图元文件句柄

参数表

参数

类型及说明

hdcRef

Long,一个参考设备场景。函数会用该设备场景在图元文件中保存与创建图元文件的那个设备的分辨率有关的信息。如设为零,表示将整个显示器(屏幕)作为参考设备使用

lpFileName

String,这个图元文件的磁盘文件名。文件应有一个.EMF扩展名。可用vbNullString传递一个NULL,从而创建内存图元文件

lpRect

RECT,一个约束矩形,用于描述图元文件的大小和位置(以0.01毫米为单位)。可用它精确定义图元文件的物理尺寸

lpDescription

String,对图元文件的一段说明。包括创建应用程序的名字、一个NULL字符、对图元文件的一段说明以及两个NULL字符。如:"My app" & chr$(0) & "my metafile" & chr$(0) & chr$(0)。如果不愿意包含一段说明,也可设为vbNullString

注解

与标准图元文件相比,增强型图元文件的一个优点在于它们包括了对图元文件实际大小和位置进行描述的信息,这些信息与它最开始创建时的情况相符。windows和绘图程序可读取这种信息,在任何设备上实际重现图元文件

Top