GetEnhMetaFileA 関数 (wingdi.h)
GetEnhMetaFile 関数は、指定されたファイルに格納されている拡張形式のメタファイルを識別するハンドルを作成します。
構文
HENHMETAFILE GetEnhMetaFileA(
[in] LPCSTR lpName
);
パラメーター
[in] lpName
拡張メタファイルの名前を指定する null で終わる文字列へのポインター。
戻り値
関数が成功した場合、戻り値は拡張メタファイルへのハンドルです。
関数が失敗した場合、戻り値は NULL
備考
アプリケーションで拡張メタファイル ハンドルが不要になったら、DeleteEnhMetaFile 関数を呼び出してハンドルを削除する必要があります。
Windows 形式のメタファイルは、GetEnhMetaFile 関数によって処理される前に、拡張形式に変換する必要があります。 ファイルを変換するには、SetWinMetaFileBits 関数を使用します。
テキスト引数で Unicode 文字を使用する必要がある場合は、ワイド文字関数としてこの関数を使用します。 テキスト引数で Windows 文字セットの文字を使用する必要がある場合は、この関数を ANSI 関数として使用します。
例
例については、「拡張メタファイルを開いてコンテンツを表示する
手記
wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetEnhMetaFile を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wingdi.h (Windows.h を含む) |
ライブラリ | Gdi32.lib |
DLL | Gdi32.dll |
関連項目
DeleteEnhMetaFile の
GetEnhMetaFile を
メタファイル関数 の
SetWinMetaFileBits の