Funzione PlayMetaFile (wingdi.h)

La funzione PlayMetaFile visualizza l'immagine archiviata nel metafile in formato Windows specificato nel dispositivo specificato.

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 è PlayEnhMetaFile.

 

Sintassi

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

Parametri

[in] hdc

Handle per un contesto di dispositivo.

[in] hmf

Gestire in un metafile in formato Windows.

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 di formato avanzato, usare la funzione SetWinMetaFileBits .

Un metafile in formato Windows può essere riprodotto più volte.

Un metafile in formato Windows può essere incorporato in un secondo metafile in formato Windows chiamando la funzione PlayMetaFile e riproducendo il metafile di origine nel contesto del dispositivo per il metafile di destinazione.

Qualsiasi oggetto creato ma non eliminato nel metafile in formato Windows viene eliminato da questa funzione.

Per arrestare questa funzione, un'applicazione può chiamare la funzione CancelDC da un altro thread per terminare l'operazione. In questo caso, la funzione restituisce FALSE.

Requisiti

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

Vedi anche

CancelDC

Funzioni metafile

Panoramica dei metafile

SetWinMetaFileBits