CreateEnhMetaFileA 函式（wingdi.h）

發行項
11/20/2024

CreateEnhMetaFile 函式會為增強格式元檔建立裝置內容。此裝置內容可用來儲存與裝置無關的圖片。

語法

HDC CreateEnhMetaFileA(
  [in] HDC        hdc,
  [in] LPCSTR     lpFilename,
  [in] const RECT *lprc,
  [in] LPCSTR     lpDesc
);

參數

[in] hdc

增強型元文件之參考裝置的句柄。此參數可以 NULL;如需詳細資訊，請參閱。

[in] lpFilename

要建立增強型元檔之檔名的指標。如果此參數 NULL，則增強型元檔是以記憶體為基礎，而且當使用 DeleteEnhMetaFile 函式刪除時，其內容會遺失。

[in] lprc

RECT 結構的指標，指定要儲存在增強元檔之圖片的維度（以 .01 公厘為單位）。

[in] lpDesc

字串的指標，指定建立圖片的應用程式名稱，以及圖片的標題。此參數可以 NULL;如需詳細資訊，請參閱。

傳回值

如果函式成功，傳回值就是增強型元檔之裝置內容的句柄。

如果函式失敗，則傳回值 NULL。

言論

其中 text 自變數必須使用 Unicode 字元，請使用 CreateEnhMetaFile 函式做為寬字元函式。其中 text 自變數必須使用 Windows 字元集的字元，請使用此函式作為 ANSI 函式。

系統會使用 hdcRef 參數所識別的參照裝置，記錄圖片最初出現所在的裝置解析度和單位。如果 hdcRef 參數 NULL，則會使用目前的顯示裝置進行參考。

RECT 結構由 lpRect 參數指向的左和頂端成員必須分別小於右和成員。矩形邊緣的點會包含在圖片中。如果 lpRectNULL，圖形裝置介面（GDI）會計算應用程式所繪製圖片的最小矩形維度。應該盡可能提供 lpRect 參數。

lpDescription 參數所指向的字串必須包含應用程式名稱和圖片名稱之間的 Null 字元，而且必須以兩個 Null 字元終止，例如“XYZ 圖形編輯器\0Bald Eagle\0\0”，其中 \0 代表 Null 字符。如果 lpDescriptionNULL，則增強元文件標頭中沒有對應的專案。

應用程式會使用此函式所建立的裝置內容，將圖形圖片儲存在增強型元檔中。識別此裝置內容的句柄可以傳遞至任何 GDI 函式。

應用程式將圖片儲存在增強型元文件之後，即可呼叫 playEnhMetaFile 函式，在任何輸出裝置上顯示圖片。顯示圖片時，系統會使用 lpRect 所指向的矩形， 參數和參考裝置的解析度數據來定位和縮放圖片。

此函式傳回的裝置內容包含與任何新裝置內容相關聯的相同預設屬性。

應用程式必須使用 GetWinMetaFileBits 函式，將增強型元檔轉換為舊版 Windows 元檔格式。

增強型元檔檔名應該使用.emf擴展名。

例子

如需範例，請參閱建立增強型元檔。

注意

wingdi.h 標頭會根據 UNICODE 預處理器常數的定義，將 CreateEnhMetaFile 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	wingdi.h （包括 Windows.h）
連結庫	Gdi32.lib
DLL	Gdi32.dll