GetEnhMetaFileW 関数 (wingdi.h)

GetEnhMetaFile 関数は、指定されたファイルに格納されている拡張形式のメタファイルを識別するハンドルを作成します。

構文

HENHMETAFILE GetEnhMetaFileW(
  [in] LPCWSTR lpName
);

パラメーター

[in] lpName

拡張メタファイルの名前を指定する null で終わる文字列へのポインター。

戻り値

関数が成功した場合、戻り値は拡張メタファイルへのハンドルです。

関数が失敗した場合は、返される値は NULL です。

解説

アプリケーションで拡張メタファイル ハンドルが不要になった場合は、 DeleteEnhMetaFile 関数を呼び出してハンドルを削除する必要があります。

Windows 形式のメタファイルは、 GetEnhMetaFile 関数で処理する前に拡張形式に変換する必要があります。 ファイルを変換するには、 SetWinMetaFileBits 関数を 使用します。

テキスト引数で Unicode 文字を使用する必要がある場合は、この関数をワイド文字関数として使用します。 テキスト引数で Windows 文字セットの文字を使用する必要がある場合は、この関数を ANSI 関数として使用します。

例

例については、「 拡張メタファイルを開いて内容を表示する」を参照してください。

Note

wingdi.h ヘッダーは、GetEnhMetaFile をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

関連項目

DeleteEnhMetaFile

GetEnhMetaFile

メタファイル関数

メタファイルの概要

SetWinMetaFileBits