PlayEnhMetaFile

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

PlayEnhMetaFile hdc, hmf, lprect

hdc : [intptr] 絵を表示する出力デバイスのデバイスコンテキストへのハンドル。
hmf : [intptr] 拡張メタファイルへのハンドル。
lprect : [var] 絵を表示するために使用する境界矩形の座標を含む RECT 構造体へのポインタ。座標は論理単位で指定する。

(プラグイン / モジュール : gdi32.dll)

解説

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

[戻り値]
関数が成功した場合、戻り値は非ゼロである。関数が失敗した場合、戻り値はゼロである。

[備考]
アプリケーションが PlayEnhMetaFile
関数を呼び出すと、システムは拡張メタファイルヘッダー内の絵のフレームを使用して、lpRect
パラメータが指す矩形に絵をマッピングする(PlayEnhMetaFile
を呼ぶ前に出力デバイスのワールド変換を設定することで、この絵を剪断または回転させることもできる)。矩形の端に沿った点は絵に含まれる。拡張メタファイルの絵は、拡張メタファイルを再生する前に出力デバイスでクリッピング領域を定義することでクリップできる。拡張メタファイルにオプションのパレットが含まれている場合、アプリケーションは
PlayEnhMetaFile
を呼ぶ前に出力デバイスにカラーパレットを設定することで、一貫した色を得ることができる。オプションのパレットを取得するには
GetEnhMetaFilePaletteEntries
関数を使用する。新しく作成された拡張メタファイルのデバイスコンテキストにソース拡張メタファイルを PlayEnhMetaFile
で再生することで、拡張メタファイルを新しい拡張メタファイルに埋め込むこともできる。出力デバイスコンテキストの状態はこの関数によって保持される。拡張メタファイル内で作成されて削除されていないオブジェクトは、この関数によって削除される。この関数を停止するために、アプリケーションは別スレッドから
CancelDC 関数を呼び出して操作を終了できる。この場合、関数は FALSE を返す。

情報