Metafile：：Metafile (IStream，HDC，constRectF&，MetafileFrameUnit，EmfType，constWCHAR) 方法 (gdiplusheaders.h)

發行項
01/10/2024

建立 Metafile：：Metafile 對象以錄製至 IStream 介面。

語法

void Metafile(
  [in]      IStream           *stream,
  [in]      HDC               referenceHdc,
  [in, ref] const RectF &     frameRect,
  [in]      MetafileFrameUnit frameUnit,
  [in]      EmfType           type,
  [in]      const WCHAR       *description
);

參數

[in] stream

類型： IStream*

指向檔案中數據流之 COM IStream 介面的指標。記錄命令時，這些命令會儲存到此數據流。

[in] referenceHdc

類型： HDC

Windows 句柄，其中包含用來記錄元文件之顯示裝置的屬性。

[in, ref] frameRect

類型： const RectF

系結元文件顯示之矩形的參考。

[in] frameUnit

類型： MetafileFrameUnit

選擇性。 MetafileFrameUnit 列舉的元素，指定 frameRect 的測量單位。預設值為 MetafileFrameUnitGdi。

[in] type

類型： EmfType

選擇性。 EmfType 列舉的元素，指定將記錄的元文件類型。預設值為 EmfTypeEmfPlusDual。

[in] description

類型： const WCHAR*

選擇性。寬字元字串的指標，指定元檔的描述性名稱。預設值是 NULL。

傳回值

無

備註

錄製到檔案時，檔案必須可寫入，而且 Windows GDI+ 必須能夠取得檔案的獨佔鎖定。

規格需求

需求	值
最低支援的用戶端	Windows XP、Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	gdiplusheaders.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll