次の方法で共有

CopyMetaFileA 関数 (wingdi.h)

  • [アーティクル]

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

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

構文

HMETAFILE CopyMetaFileA(
  [in] HMETAFILE unnamedParam1,
  [in] LPCSTR    unnamedParam2
);

パラメーター

[in] unnamedParam1

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

[in] unnamedParam2

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

戻り値

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

関数が失敗した場合、戻り値は NULL。

備考

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

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wingdi.h (Windows.h を含む)
ライブラリ Gdi32.lib
DLL Gdi32.dll

関連項目

DeleteMetaFile の

メタファイル関数 の

メタファイルの概要