Condividi tramite


CDC::PlayMetaFile

Riproduce il contenuto di un metafile specificate nel contesto di dispositivo.

BOOL PlayMetaFile( 
   HMETAFILE hMF  
); 
BOOL PlayMetaFile( 
   HENHMETAFILE hEnhMetaFile, 
   LPCRECT lpBounds  
);

Parametri

  • hMF
    Identifica un metafile da riprodurre.

  • hEnhMetaFile
    Consente di identificare Enhanced Metafile.

  • lpBounds
    Punta a RECT struttura o un oggetto CRect che include le coordinate del rettangolo di delimitazione utilizzato per visualizzare l'immagine. Le coordinate specificate in unità logiche.

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario 0.

Note

I metafile possono essere riprodotte un numero illimitato di volte.

La seconda versione PlayMetaFile visualizzare l'immagine memorizzata in un metafile specificate di avanzato- formato. Quando un'applicazione chiama la seconda versione PlayMetaFile, Windows utilizza la cornice nell'intestazione di Enhanced Metafile per eseguire il mapping dell'immagine nel rettangolo puntato dal parametro lpBounds. (Questa immagine è possibile tosata o ruotata impostando la trasformazione world del dispositivo di output prima di chiamare PlayMetaFile). I punti lungo i bordi del rettangolo vengono inclusi nell'immagine. Un'immagine di Enhanced Metafile può essere inserita definisce l'area di ridimensionamento nel dispositivo di output prima di riprodurre l'operazione Enhanced Metafile.

Se un Enhanced Metafile contiene una tavolozza facoltativa, un'applicazione può raggiungere i colori e installa una tavolozza dei colori nel dispositivo di output prima di chiamare la seconda versione PlayMetaFile. Per recuperare la tavolozza facoltativa, utilizzare la funzione di Windows GetEnhMetaFilePaletteEntries. Un Enhanced Metafile può essere incorporato in un Enhanced Metafile appena creato chiamando la seconda versione PlayMetaFile e riproduzione di l Enhanced Metafile di origine nel contesto di dispositivo per il nuovo Enhanced Metafile.

Stati del contesto del dispositivo di output vengono mantenuti dalla funzione. Ogni oggetto creato ma non eliminato in l Enhanced Metafile viene eliminato dalla funzione. Per interrompere la funzione, un'applicazione può chiamare la funzione Windows CancelDC da un altro thread per terminare l'operazione. In questo caso, restituisce zero di funzione.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CDC

Grafico delle gerarchie

CancelDC

GetEnhMetaFileHeader

GetEnhMetaFilePaletteEntries

SetWorldTransform

PlayMetaFile

PlayEnhMetaFile

PlayMetaFile