PlayEnhMetaFile 函式 (wingdi.h)

PlayEnhMetaFile函式會顯示儲存在指定增強格式中繼檔中的圖片。

語法

BOOL PlayEnhMetaFile(
  [in] HDC          hdc,
  [in] HENHMETAFILE hmf,
  [in] const RECT   *lprect
);

[in] hdc

顯示圖片之輸出裝置之裝置內容的控制碼。

[in] hmf

增強型中繼檔控制碼。

[in] lprect

RECT結構的指標，其中包含用來顯示圖片之周框座標。座標會以邏輯單元指定。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

當應用程式呼叫 PlayEnhMetaFile 函式時，系統會使用增強中繼檔標頭中的圖片框架，將圖片對應至 lpRect 參數所指向的矩形。 (在呼叫 PlayEnhMetaFile.) 矩形邊緣的點之前，設定輸出裝置中的世界轉換，可能會改變或旋轉此圖片。

在播放增強的中繼檔之前，可以在輸出裝置中定義裁剪區域來裁剪增強中繼檔圖片。

如果增強型中繼檔包含選擇性調色盤，應用程式可以在輸出裝置上設定調色盤，再呼叫 PlayEnhMetaFile，以達到一致的色彩。若要擷取選擇性調色盤，請使用 GetEnhMetaFilePaletteEntries 函式。

增強型中繼檔可以藉由呼叫 PlayEnhMetaFile ，並將來源增強的中繼檔內嵌到新增強中繼檔裝置內容中，以內嵌至新增強中繼檔。

此函式會保留輸出裝置內容的狀態。此函式會刪除在增強型中繼檔中建立但未刪除的任何物件。

若要停止此函式，應用程式可以從另一個執行緒呼叫 CancelDC 函式來終止作業。在此情況下，函式會傳回 FALSE。