CDC::PlayMetaFile

發行項
02/28/2013

播放指定中繼檔的內容在裝置內容的。

BOOL PlayMetaFile(
   HMETAFILE hMF 
);
BOOL PlayMetaFile(
   HENHMETAFILE hEnhMetaFile,
   LPCRECT lpBounds 
);

參數

hMF
識別要使用的此中繼檔。
hEnhMetaFile
識別這個加強型中繼檔。
lpBounds
為 RECT 的點建構或含有用來週框座標顯示圖片的 CRect 物件。座標是以邏輯單位指定。

傳回值

如果不是零，則函式成功，則為 0。

備註

此中繼資料可以播放任意次數。

PlayMetaFile 第二個版本顯示在特定加強型格式中繼檔中的圖片。當應用程式呼叫時 PlayMetaFile第二個版本，視窗在加強型中繼檔標頭使用繪製方塊將矩形的圖片所指向的 lpBounds 參數。(這個圖片可能修剪或旋轉藉由設定世界 Transform 在輸出裝置上呼叫 PlayMetaFile之前)。沿著矩形邊緣的位置在圖片中。加強型中繼檔圖片可以藉由定義輸出裝置的裁剪區域會在播放此加強型中繼檔之前。

如果提供了增強型中繼檔中的選擇性調色盤，應用程式可以設定在輸出裝置的色板達成一致的色彩在呼叫 PlayMetaFile第二個版本之前。若要擷取選擇性調色盤，請使用 GetEnhMetaFilePaletteEntries Windows 函式。一個加強型中繼檔在新建立的加強型中繼檔可以內嵌藉由呼叫 PlayMetaFile 第二版和播放此來源加強型中繼檔匯入新加強型中繼檔的裝置內容。

輸出裝置內容的狀態儲存由這個函式。在加強型中繼檔已建立，但無法刪除的物件都會由這個函式會刪除。若要停止此函式，應用程式可以呼叫另一個執行緒的 CancelDC Windows 函式終止作業。在這種情況下，函式會傳回零。