CDC::PlayMetaFile
デバイス コンテキストの指定されたメタファイルの内容をします。
BOOL PlayMetaFile(
HMETAFILE hMF
);
BOOL PlayMetaFile(
HENHMETAFILE hEnhMetaFile,
LPCRECT lpBounds
);
パラメーター
hMF
必要遊ばれるメタファイルを識別します。hEnhMetaFile
拡張メタファイルを識別します。lpBounds
RECT をポイントし、またはイメージの表示に使用される外接する四角形の座標を格納するオブジェクトの CRect 構成します。座標は論理単位で指定します。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
メタファイルは何回でも再描画できます。
PlayMetaFile の 2 番目のバージョンは、特定の拡張フォーマットのメタファイルに格納されている画像を表示します。アプリケーションが PlayMetaFileの 2 番目のバージョンを呼び出すと、Windows は拡張メタファイル ヘッダーに lpBounds のパラメーターが指す四角形に画像を割り当てるに額縁を使用します。(この画像は PlayMetaFileを呼び出す前の出力デバイスのワールド変換を設定して、傾斜または回転できます)。四角形の端に沿ってポイントは、画像に含まれます。拡張メタファイルの図は、拡張メタファイルを行う前の出力デバイスのクリッピング領域の定義によってクリップすることもできます。
拡張メタファイルが省略可能なパレットが含まれる場合、アプリケーションは、出力デバイスのカラー パレットを設定して PlayMetaFileの 2 番目のバージョンを呼び出す前に一貫した色を実行できます。オプションのパレットを取得するには、GetEnhMetaFilePaletteEntries Windows の関数を使用します。拡張メタファイルは、新しく作成された拡張メタファイルに PlayMetaFile の 2 番目のバージョンを呼び出し、新しい拡張メタファイルのデバイス コンテキストによって強化されたメタファイルをして埋め込むことができます。
出力デバイス コンテキストの状態は、この関数によって保持されます。拡張メタファイルに作成され、削除されないオブジェクトはこの関数によって削除されます。この関数を停止するには、アプリケーションが操作を終了する場合に、別のスレッドから CancelDC Windows の関数を呼び出すことができます。この場合、関数のゼロを返します。
必要条件
ヘッダー: afxwin.h