SetWinMetaFileBits 関数 (wingdi.h)
SetWinMetaFileBits 関数は、古い Windows 形式から新しい拡張形式にメタファイルを変換し、新しいメタファイルをメモリに格納します。
構文
HENHMETAFILE SetWinMetaFileBits(
[in] UINT nSize,
[in] const BYTE *lpMeta16Data,
[in] HDC hdcRef,
[in] const METAFILEPICT *lpMFP
);
パラメーター
[in] nSize
Windows 形式のメタファイルを含むバッファーのサイズ (バイト単位)。
[in] lpMeta16Data
Windows 形式のメタファイル データを含むバッファーへのポインター。 (データは GetMetaFileBitsEx または GetWinMetaFileBits 関数を使用して取得されたものと見 な されます)。
[in] hdcRef
参照デバイス コンテキストへのハンドル。
[in] lpMFP
メタファイル画像の推奨サイズと、画像の作成時に使用されたマッピング モードを含む METAFILEPICT 構造体へのポインター。
戻り値
関数が成功した場合、戻り値はメモリベースの拡張メタファイルへのハンドルです。
関数が失敗した場合は、返される値は NULL です。
注釈
Windows では、参照デバイス コンテキストの解決データと METAFILEPICT 構造体内のデータを使用して画像をスケーリングします。 hdcRef パラメーターが NULL の場合、システムは現在の出力デバイスの解像度データを使用します。 lpmfp パラメーターが NULL の場合、システムはMM_ANISOTROPIC マッピング モードを使用して画像をスケーリングし、デバイスの表面全体に収まるようにします。 METAFILEPICT 構造体の hMF メンバーは使用されません。
アプリケーションで拡張メタファイル ハンドルが不要になった場合は、 DeleteEnhMetaFile 関数を呼び出して削除する必要があります。
この関数によって返されるハンドルは、他の拡張メタファイル関数と共に使用できます。
参照デバイス コンテキストが、メタファイルが最初に作成されたデバイスと同じでない場合、デバイスユニットを使用する GDI 関数の中には、画像が正しく描画されない場合があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |