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 |