Funzione PlayEnhMetaFile (wingdi.h)

Articolo
08/27/2023

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