PlayEnhMetaFileRecord 関数 (wingdi.h)

PlayEnhMetaFileRecord 関数は、レコードによって識別されるグラフィックス デバイス インターフェイス (GDI) 関数を実行することで、拡張メタファイル レコードを再生します。

構文

BOOL PlayEnhMetaFileRecord(
  [in] HDC                 hdc,
  [in] LPHANDLETABLE       pht,
  [in] const ENHMETARECORD *pmr,
  [in] UINT                cht
);

パラメーター

[in] hdc

EnumEnhMetaFile 関数に渡されるデバイス コンテキストへのハンドル。

[in] pht

メタファイルの再生時に使用される GDI オブジェクトへのハンドルのテーブルへのポインター。 このテーブルの最初のエントリには、拡張メタファイル ハンドルが含まれています。

[in] pmr

再生する拡張メタファイル レコードへのポインター。

[in] cht

ハンドル テーブル内のハンドルの数。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

注釈

これは拡張メタファイル関数です。

通常、アプリケーションは PlayEnhMetaFileRecord を EnumEnhMetaFile 関数と組み合わせて使用して、拡張形式のメタファイルを一度に 1 つのレコードで処理および再生します。

hdc、lpHandletable、および nHandles パラメーターは、EnumEnhMetaFile 関数によって EnhMetaFileProc コールバック プロシージャに渡されるパラメーターとまったく同じでなければなりません。

PlayEnhMetaFileRecord がレコードを認識しない場合、レコードは無視され、TRUE が返されます。

要件

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

こちらもご覧ください

EnumEnhMetaFile

メタファイル関数

メタファイルの概要

PlayEnhMetaFile