PlayMetaFile 関数 (wingdi.h)

PlayMetaFile 関数は、指定されたデバイス上の特定の Windows 形式のメタファイルに格納されている画像を表示します。

メモこの関数は、Windows 形式のメタファイルとの互換性のためにのみ提供されます。拡張形式のメタファイルは優れた機能を提供し、新しいアプリケーションに推奨されます。拡張形式メタファイルの対応する関数は PlayEnhMetaFile です。

構文

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

[in] hdc

デバイスコンテキストを識別するハンドル。

[in] hmf

Windows 形式のメタファイルを処理します。

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

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

Windows 形式のメタファイルを拡張形式のメタファイルに変換するには、 SetWinMetaFileBits 関数を使用します。

Windows 形式のメタファイルは、複数回再生できます。

Windows 形式のメタファイルは、 PlayMetaFile 関数を呼び出し、ソースメタファイルをターゲットメタファイルのデバイスコンテキストに再生することで、2 番目の Windows 形式のメタファイルに埋め込むことができます。

Windows 形式のメタファイルで作成されたが削除されていないオブジェクトはすべて、この関数によって削除されます。

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


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll