PlayMetaFileRecord 関数 (wingdi.h)

PlayMetaFileRecord 関数は、そのレコードに含まれるグラフィックスデバイスインターフェイス (GDI) 関数を実行することで、Windows 形式のメタファイルレコードを再生します。

メモこの関数は、Windows 形式のメタファイルとの互換性のためにのみ提供されます。拡張形式のメタファイルは優れた機能を提供し、新しいアプリケーションに推奨されます。拡張形式メタファイルの対応する関数は PlayEnhMetaFileRecord です。

構文

BOOL PlayMetaFileRecord(
  [in] HDC           hdc,
  [in] LPHANDLETABLE lpHandleTable,
  [in] LPMETARECORD  lpMR,
  [in] UINT          noObjs
);

[in] hdc

デバイスコンテキストを識別するハンドル。

[in] lpHandleTable

メタファイルの再生時に使用される GDI オブジェクトへのハンドルのテーブルを表す HANDLETABLE 構造体へのポインター。

[in] lpMR

Windows 形式のメタファイルレコードへのポインター。

[in] noObjs

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

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

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

Windows 形式のメタファイルを拡張形式のメタファイルに変換するには、 SetWinMetaFileBits 関数を使用します。

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

lpHandletable パラメーターと nHandles パラメーターは、EnumMetaFile によって EnumMetaFileProc コールバックプロシージャに渡されるものと同じである必要があります。

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

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