SetWinMetaFileBits 関数 (wingdi.h)

[アーティクル]
08/27/2023

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