Funzione PlayEnhMetaFile (wingdi.h)
La funzione PlayEnhMetaFile visualizza l'immagine archiviata nel metafile di formato avanzato specificato.
Sintassi
BOOL PlayEnhMetaFile(
[in] HDC hdc,
[in] HENHMETAFILE hmf,
[in] const RECT *lprect
);
Parametri
[in] hdc
Handle al contesto del dispositivo per il dispositivo in cui verrà visualizzata l'immagine.
[in] hmf
Handle per il metafile avanzato.
[in] lprect
Puntatore a una struttura RECT che contiene le coordinate del rettangolo di selezione utilizzato per visualizzare l'immagine. Le coordinate vengono specificate in unità logiche.
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
Quando un'applicazione chiama la funzione PlayEnhMetaFile , il sistema usa la cornice immagine nell'intestazione metafile avanzata per eseguire il mapping dell'immagine sul rettangolo a cui punta il parametro lpRect . Questa immagine può essere sheared o ruotata impostando la trasformazione del mondo nel dispositivo di output prima di chiamare PlayEnhMetaFile. I punti lungo i bordi del rettangolo sono inclusi nell'immagine.
Un'immagine metafile avanzata può essere ritagliata definendo l'area di ritaglio nel dispositivo di output prima di riprodurre il metafile avanzato.
Se un metafile avanzato contiene una tavolozza facoltativa, un'applicazione può ottenere colori coerenti impostando una tavolozza colori nel dispositivo di output prima di chiamare PlayEnhMetaFile. Per recuperare la tavolozza facoltativa, usare la funzione GetEnhMetaFilePaletteEntries .
Un metafile avanzato può essere incorporato in un metafile avanzato appena creato chiamando PlayEnhMetaFile e giocando il metafile avanzato di origine nel contesto del dispositivo per il nuovo metafile avanzato.
Gli stati del contesto del dispositivo di output vengono mantenuti da questa funzione. Qualsiasi oggetto creato ma non eliminato nel metafile avanzato 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.
Esempio
Per un esempio, vedere Apertura di un metafile avanzato e visualizzazione del relativo contenuto.
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 |