Funzione PlayMetaFileRecord (wingdi.h)

Articolo
03/04/2024

La funzione PlayMetaFileRecord riproduce un record metafile in formato Windows eseguendo la funzione GDI (Graphics Device Interface) contenuta all'interno di tale record.

Nota Questa funzione viene fornita solo per la compatibilità con i metafile in formato Windows. I metafile in formato avanzato offrono funzionalità superiori e sono consigliati per le nuove applicazioni. La funzione corrispondente per un metafile in formato avanzato è PlayEnhMetaFileRecord.

Sintassi

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

Parametri

[in] hdc

Handle per un contesto di dispositivo.

[in] lpHandleTable

Puntatore a una struttura HANDLETABLE che rappresenta la tabella degli handle per gli oggetti GDI utilizzati durante la riproduzione del metafile.

[in] lpMR

Puntatore al record metafile in formato Windows.

[in] noObjs

Numero di handle nella tabella handle.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Per convertire un metafile in formato Windows in un metafile in formato avanzato, usare la funzione SetWinMetaFileBits .

Un'applicazione usa in genere PlayMetaFileRecord insieme alla funzione EnumMetaFile per elaborare e riprodurre un metafile in formato Windows un record alla volta.

I parametri lpHandletable e nHandles devono essere identici a quelli passati alla routine di callback EnumMetaFileProc di EnumMetaFile.

Se la funzione PlayMetaFileRecord non riconosce un record, ignora il record e restituisce TRUE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll