SetWinMetaFileBits

SetWinMetaFileBits 関数は、メタファイルを古い Windows 形式から新しい拡張形式に変換し、新しいメタファイルをメモリに格納する。

SetWinMetaFileBits nSize, lpMeta16Data, hdcRef, lpMFP

nSize : [int] Windows 形式メタファイルを含むバッファのサイズ(バイト単位)。
lpMeta16Data : [var] Windows 形式メタファイルデータを含むバッファへのポインタ(データは GetMetaFileBitsEx または GetWinMetaFileBits 関数を使って取得されたと想定される)。
hdcRef : [intptr] 参照デバイスコンテキストへのハンドル。
lpMFP : [var] メタファイル画像の推奨サイズと画像作成時に使用されたマッピングモードを含む METAFILEPICT 構造体へのポインタ。

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

解説

SetWinMetaFileBits 関数は、メタファイルを古い Windows
形式から新しい拡張形式に変換し、新しいメタファイルをメモリに格納する。

[戻り値]
関数が成功した場合、戻り値はメモリベースの拡張メタファイルへのハンドルである。関数が失敗した場合、戻り値は NULL である。

[備考]
Windows は参照デバイスコンテキストの解像度データと METAFILEPICT
構造体内のデータを使用して画像をスケーリングする。hdcRef パラメータが NULL
の場合、システムは現在の出力デバイスの解像度データを使用する。lpmfp パラメータが NULL の場合、システムは
MM_ANISOTROPIC マッピングモードを使用して画像をデバイスサーフェス全体に合わせてスケーリングする。METAFILEPICT
構造体の hMF
メンバは使用されない。アプリケーションが拡張メタファイルハンドルを必要としなくなったら、DeleteEnhMetaFile
関数を呼び出して削除すべきである。この関数によって返されるハンドルは他の拡張メタファイル関数と共に使用できる。参照デバイスコンテキストがメタファイルが元々作成されたデバイスと同一でない場合、デバイス単位を使用する一部の
GDI 関数が画像を正しく描画しないことがある。

情報