EnumEnhMetaFile 関数 (wingdi.h)

EnumEnhMetaFile 関数は、各レコードを取得し、指定されたコールバック関数に渡すことによって、拡張形式のメタファイル内のレコードを列挙します。 アプリケーション提供のコールバック関数は、必要に応じて各レコードを処理します。 列挙は、最後のレコードが処理されるまで、またはコールバック関数が 0 を返すまで続きます。

構文

BOOL EnumEnhMetaFile(
  [in] HDC           hdc,
  [in] HENHMETAFILE  hmf,
  [in] ENHMFENUMPROC proc,
  [in] LPVOID        param,
  [in] const RECT    *lpRect
);

パラメーター

[in] hdc

デバイス コンテキストを識別するハンドル。 このハンドルはコールバック関数に渡されます。

[in] hmf

拡張メタファイルを識別するハンドル。

[in] proc

アプリケーション提供のコールバック関数へのポインター。 詳細については、 EnhMetaFileProc 関数を参照してください。

[in] param

省略可能なコールバック関数データへのポインター。

[in] lpRect

図の左上隅と右下隅の座標を論理単位で指定する RECT 構造体へのポインター。

戻り値

コールバック関数が拡張メタファイル内のすべてのレコードを正常に列挙した場合、戻り値は 0 以外になります。

コールバック関数が拡張メタファイル内のすべてのレコードを正常に列挙しない場合、戻り値は 0 になります。

解説

lpRect パラメーターが指す四角形の端に沿ったポイントが図に含まれます。 hdc パラメーターが NULL の場合、システムは lpRect を無視します。

コールバック関数が PlayEnhMetaFileRecord 関数を呼び出す場合、 hdc は有効なデバイス コンテキストを識別する必要があります。 システムは、デバイス コンテキストの変換とマッピング モードを使用して、 PlayEnhMetaFileRecord 関数によって表示される画像を変換します。

EnumEnhMetaFile 関数を使用して、1 つの拡張メタファイルを別の拡張メタファイルに埋め込むことができます。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

関連項目

EnhMetaFileProc

メタファイル関数

メタファイルの概要

PlayEnhMetaFile

PlayEnhMetaFileRecord

Rect