CreateEnhMetaFile

CreateEnhMetaFile是一則函式，創建一個增強型的圖元檔案設備場景。繪圖操作也許在這個設備場景中執行。調用CloseEnhMetaFile函式關閉了這個設備場景後，會創建一個圖元檔案句柄，在其中包含記錄下來的繪圖命令序列。隨後，可在任何設備場景中回放這些命令。

別名

CreateEnhMetaFileA

說明

創建一個增強型的圖元檔案設備場景。繪圖操作也許在這個設備場景中執行。調用CloseEnhMetaFile函式關閉了這個設備場景後，會創建一個圖元檔案句柄，在其中包含記錄下來的繪圖命令序列。隨後，可在任何設備場景中回放這些命令。

聲明

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

參數表

hdcRef --------- Long，一個參考設備場景。函式會用該設備場景在圖元檔案中保存與創建圖元檔案的那個設備的解析度有關的信息。如設為零，表示將整個顯示器（螢幕）作為參考設備使用。

lpFileName ----- String，這個圖元檔案的磁碟檔案名稱。檔案應有一個.EMF擴展名。可用vbNullString傳遞一個NULL，從而創建記憶體圖元檔案。

lpRect --------- RECT，一個約束矩形，用於描述圖元檔案的大小和位置（以0.01毫米為單位）。可用它精確定義圖元檔案的物理尺寸。

lpDescription -- String，對圖元檔案的一段說明。包括創建應用程式的名字、一個NULL字元、對圖元檔案的一段說明以及兩個NULL字元。如："Myapp" & chr$(0) & "my metafile" & chr$(0) & chr$(0)。如果不願意包含一段說明，也可設為vbNullString。

返回值

Long，一個增強型圖元檔案設備場景。零表示函式執行出錯。不要將這個設備場景與圖元檔案句柄混淆起來。圖元檔案設備場景用於描繪圖元檔案——這與GDI繪圖函式作為參數使用的其他任何設備場景是一樣的。調用CloseEnhMetaFile函式的時候，會獲得實際的圖元檔案句柄。

其它

與標準圖元檔案相比，增強型圖元檔案的一個優點在於它們包括了對圖元檔案實際大小和位置進行描述的信息，這些信息與它最開始創建時的情況相符。windows和繪圖程式可讀取這種信息，在任何設備上實際重現圖元檔案。