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