PlayEnhMetaFile 関数 (wingdi.h)

PlayEnhMetaFile 関数は、指定された拡張形式のメタファイルに格納されている画像を表示します。

構文

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

パラメーター

[in] hdc

画像が表示される出力デバイスのデバイス コンテキストへのハンドル。

[in] hmf

拡張メタファイルへのハンドル。

[in] lprect

図の表示に使用される外接する四角形の座標を含む RECT 構造体へのポインター。 座標は論理単位で指定されます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

解説

アプリケーションが PlayEnhMetaFile 関数を呼び出すと、システムは enhanced-metafile ヘッダーのピクチャ フレームを使用して、 lpRect パラメーターが指す四角形に画像をマップします。 (この画像は、 PlayEnhMetaFile を呼び出す前に出力デバイスでワールド変換を設定することで、せん断または回転できます)。四角形の端に沿ったポイントが図に含まれます。

拡張メタファイルを再生する前に、出力デバイスでクリッピング領域を定義することで、拡張メタファイル画像をクリップできます。

拡張メタファイルにオプションのパレットが含まれている場合、 PlayEnhMetaFile を呼び出す前に出力デバイスにカラー パレットを設定することで、アプリケーションで一貫性のある色を実現できます。 オプションのパレットを取得するには、 GetEnhMetaFilePaletteEntries 関数を 使用します。

拡張メタファイルは、 PlayEnhMetaFile を呼び出し、ソース拡張メタファイルを新しい拡張メタファイルのデバイス コンテキストに再生することで、新しく作成された拡張メタファイルに埋め込むことができます。

出力デバイス コンテキストの状態は、この関数によって保持されます。 拡張メタファイルで作成されたオブジェクトは削除されませんが、この関数によって削除されます。

この関数を停止するために、アプリケーションは別のスレッドから CancelDC 関数を呼び出して操作を終了できます。 この場合、関数は FALSE を返します。

例

例については、「 拡張メタファイルを開いて内容を表示する」を参照してください。

要件

関連項目

CancelDC

GetEnhMetaFileHeader

GetEnhMetaFilePaletteEntries

メタファイル関数

メタファイルの概要

Rect