EnumMetaFile 関数 (wingdi.h)
EnumMetaFile 関数は、各レコードを取得し、指定されたコールバック関数に渡すことによって、Windows 形式のメタファイル内のレコードを列挙します。 アプリケーション提供のコールバック関数は、必要に応じて各レコードを処理します。 列挙は、最後のレコードが処理されるまで、またはコールバック関数が 0 を返すまで続きます。
メモ この関数は、Windows 形式のメタファイルとの互換性のためにのみ提供されます。 拡張形式のメタファイルは優れた機能を提供し、新しいアプリケーションに推奨されます。 拡張形式メタファイルの対応する関数は EnumEnhMetaFile です。
構文
BOOL EnumMetaFile(
[in] HDC hdc,
[in] HMETAFILE hmf,
[in] MFENUMPROC proc,
[in] LPARAM param
);
パラメーター
[in] hdc
デバイス コンテキストを識別するハンドル。 このハンドルはコールバック関数に渡されます。
[in] hmf
Windows 形式のメタファイルを処理します。
[in] proc
アプリケーション提供のコールバック関数へのポインター。 詳細については、「 EnumMetaFileProc」を参照してください。
[in] param
省略可能なデータへのポインター。
戻り値
コールバック関数が Windows 形式のメタファイル内のすべてのレコードを正常に列挙した場合、戻り値は 0 以外になります。
コールバック関数が Windows 形式のメタファイル内のすべてのレコードを正常に列挙しない場合、戻り値は 0 になります。
注釈
Windows 形式のメタファイルを拡張形式のメタファイルに変換するには、 SetWinMetaFileBits 関数を使用します。
EnumMetaFile 関数を使用して、1 つの Windows 形式メタファイルを別の Windows 形式のメタファイルに埋め込むことができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |