CopyMetaFileA 函式 (wingdi.h)
CopyMetaFile 函式會將 Windows 格式元檔的內容複製到指定的檔案。
注意 此函式僅供與 Windows 格式元檔相容。 增強格式元檔提供優越的功能,並建議用於新的應用程式。 增強格式元檔對應的函式 CopyEnhMetaFile。
語法
HMETAFILE CopyMetaFileA(
[in] HMETAFILE unnamedParam1,
[in] LPCSTR unnamedParam2
);
參數
[in] unnamedParam1
來源 Windows 格式元檔句柄。
[in] unnamedParam2
目的地檔名的指標。 如果此參數 NULL,則會將來源元檔複製到記憶體。
傳回值
如果函式成功,傳回值就是 Windows 格式元文件複本的句柄。
如果函式失敗,則傳回值 NULL。
言論
其中文字自變數必須使用 Unicode 字元,請使用此函式做為寬字元函式。 其中 text 自變數必須使用 Windows 字元集的字元,請使用此函式作為 ANSI 函式。
當應用程式不再需要 Windows 格式元檔句柄時,應該呼叫 DeleteMetaFile 函式來刪除句柄。
注意
wingdi.h 標頭會將 CopyMetaFile 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | wingdi.h (包括 Windows.h) |
連結庫 | Gdi32.lib |
DLL | Gdi32.dll |