EnumMetaFile 関数 (wingdi.h)

[アーティクル]
08/27/2023

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