CreateMetaFileW 関数 (wingdi.h)
CreateMetaFile 関数は、Windows 形式のメタファイルのデバイス コンテキストを作成します。
構文
HDC CreateMetaFileW(
[in] LPCWSTR 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 バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示