PlayMetaFile

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

PlayMetaFile hdc, hmf

hdc : [intptr] デバイスコンテキストへのハンドル。
hmf : [intptr] Windows 形式メタファイルへのハンドル。

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

解説

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

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

[備考]
Windows 形式メタファイルを拡張形式メタファイルに変換するには、SetWinMetaFileBits 関数を使用する。Windows
形式メタファイルは複数回再生できる。PlayMetaFile
関数を呼び出してソースメタファイルをターゲットメタファイルのデバイスコンテキストに再生することで、Windows 形式メタファイルを別の
Windows 形式メタファイルに埋め込むこともできる。Windows
形式メタファイル内で作成されて削除されていないオブジェクトは、この関数によって削除される。この関数を停止するために、アプリケーションは別スレッドから
CancelDC 関数を呼び出して操作を終了できる。この場合、関数は FALSE を返す。

情報

プラグイン / モジュールgdi32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の gdi32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_gdi32_gen2.hs