CopyMetaFileW 関数 (wingdi.h)

CopyMetaFile 関数は、Windows 形式のメタファイルの内容を指定したファイルにコピーします。

メモ この関数は、Windows 形式のメタファイルとの互換性のためにのみ提供されます。 拡張形式のメタファイルは優れた機能を提供し、新しいアプリケーションに推奨されます。 拡張形式メタファイルの対応する関数は CopyEnhMetaFile です。

 

構文

HMETAFILE CopyMetaFileW(
  [in] HMETAFILE unnamedParam1,
  [in] LPCWSTR   unnamedParam2
);

パラメーター

[in] unnamedParam1

ソース Windows 形式のメタファイルへのハンドル。

[in] unnamedParam2

コピー先ファイルの名前へのポインター。 このパラメーターが NULL の場合、ソース メタファイルはメモリにコピーされます。

戻り値

関数が成功した場合、戻り値は Windows 形式のメタファイルのコピーへのハンドルです。

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

解説

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

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

注意

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

要件

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

関連項目

DeleteMetaFile

メタファイル関数

メタファイルの概要