CMetaFileDC::CreateEnhanced

發行項
02/28/2013

建立加強型格式中繼檔的裝置內容。

BOOL CreateEnhanced(
   CDC* pDCRef,
   LPCTSTR lpszFileName,
   LPCRECT lpBounds,
   LPCTSTR lpszDescription 
);

參數

pDCRef
識別這個加強型中繼檔的參考裝置。
lpszFileName
為 null 結尾字元字串的點。指定檔名才會建立這個的加強型中繼檔。如果此參數為，這個 NULL加強型中繼檔記憶體為基礎，而其內容遺失，在物件終結時，或當 DeleteEnhMetaFile Win32 函式呼叫時。
lpBounds
為的長度資料結構或在 HIMETRIC 單位指定維度的 CRect 物件的點 (.01 公釐加入在加強型中繼檔會儲存) 的圖片。
lpszDescription
為指定的應用程式名稱建立圖片的以零結尾之字串的點，以及圖片的標題。

傳回值

裝置內容的控制代碼加強型中繼檔的，則為，如果成功，否則 NULL。

備註

此網域控制站 (DC) 可以用來儲存與裝置無關的圖片。

視窗中使用 pDCRef 參數所識別的參考裝置記錄圖片最初會顯示裝置的解析度和單位。如果 pDCRef 參數是 NULL，它會使用目前顯示裝置的參考。

RECT 資料結構的左方和上方成員所指向的 lpBounds 參數小於右邊和底部成員，必須分別。沿著矩形邊緣的位置在圖片中。如果是， lpBoundsNULL圖形裝置介面 (GDI) 計算可以封入應用程式繪製圖片的最小矩形的維度。應該盡量提供 lpBounds 參數。

字串所指向的 lpszDescription 參數必須包含應用程式名稱和圖片名稱之間的 null 字元，而且必須終止兩個 null 字元 (範例中，「XYZ 圖形編輯器中\0Bald Eagle \ 0 \ 0 \」， 0 表示 null 字元的位置。如果 lpszDescription 是 NULL，不會用在加強型中繼檔標頭的對應的項目。

應用程式在加強型中繼檔使用這個函式會建立的 DC 儲存圖形圖片。識別這個網域控制站 (DC) 的控制代碼可以傳遞至任何 GDI 函式。

在應用程式在加強型中繼檔之後儲存圖片，可以呼叫 CDC::PlayMetaFile 函式顯示所有輸出裝置的圖片。當顯示圖片時， Windows 會使用矩形所指向的 lpBounds 參數和解析資料從參考裝置定位和縮放圖片。這個函式傳回的裝置內容包含相同的預設屬性與任何新的 DC。

應用程式必須使用 Win32 函式 GetWinMetaFileBits 轉換一個加強型中繼檔至舊版的 Windows 中繼檔格式。

這個加強型中繼檔的檔名應該使用 .EMF 副檔名。