CreateMetaFileA 関数 (wingdi.h)
CreateMetaFile 関数は、Windows 形式のメタファイルのデバイス コンテキストを作成します。
構文
HDC CreateMetaFileA(
[in] LPCSTR pszFile
);
パラメーター
[in] pszFile
作成する Windows 形式のメタファイルのファイル名へのポインター。 このパラメーターが NULL の場合、Windows 形式のメタファイルはメモリ ベースであり、 DeleteMetaFile 関数を使用して削除すると、その内容は失われます。
戻り値
関数が成功した場合、戻り値は Windows 形式のメタファイルのデバイス コンテキストへのハンドルです。
関数が失敗した場合は、返される値は NULL です。
注釈
テキスト引数で Unicode 文字を使用する必要がある場合は、ワイド文字関数として CreateMetaFile 関数を使用します。 テキスト引数で Windows 文字セットの文字を使用する必要がある場合は、この関数を ANSI 関数として使用します。
CreateMetaFile は、Windows 形式のメタファイル関数です。 この関数は、Windows 形式メタファイルに記載されている 16 ビットの Windows ベースのアプリケーションのみをサポートします。 16 ビット Windows の一部ではなかった PolyBezier などの GDI 関数は記録または再生されません。
この関数によって作成されたデバイス コンテキストを使用して、GDI 出力関数を Windows 形式のメタファイルに記録できます。 GetTextColor などの GDI クエリ関数では使用できません。 デバイス コンテキストが GDI 出力関数と共に使用される場合、関数が記録されている場合、その関数の戻り値は TRUE になり、それ以外の場合は FALSE になります。 SelectObject 関数を使用してオブジェクトを選択すると、オブジェクトのコピーのみが記録されます。 オブジェクトは引き続きアプリケーションに属しています。
スケーラブルな Windows 形式のメタファイルを作成するには、グラフィックス出力をMM_ANISOTROPICマッピング モードで記録します。 ファイルには、ビューポートの原点とエクステントを変更する関数を含めることはできません。また、 SelectClipRgn 関数などのデバイスに依存する関数を含めることもできます。 作成した Windows メタファイルは、イメージを再生する前にビューポートの原点とエクステントを定義することで、任意の出力デバイス形式にスケーリングおよびレンダリングできます。
注意
wingdi.h ヘッダーは、CreateMetaFile をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |