Share via


CDC::PlayMetaFile

Reproduce el contenido de metarchivo especificado en el contexto del dispositivo.

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

Parámetros

  • hMF
    Identifica el metarchivo que se reproducirá.

  • hEnhMetaFile
    Identifica el metarchivo mejorado.

  • lpBounds
    Señala una estructura de RECT o un objeto de CRect que contiene las coordenadas del rectángulo delimitador utilizado para mostrar la imagen.las coordenadas se especifican en unidades lógicas.

Valor devuelto

Distinto de cero si la función es correcta; si no 0.

Comentarios

El metarchivo se puede reproducir cualquier número de veces.

La segunda versión de PlayMetaFile muestra la imagen almacenada en el metarchivo especificado de ampliar-formato.Cuando una aplicación llama a la segunda versión de PlayMetaFile, Windows utiliza el marco de imagen en el encabezado de metarchivo mejorado para asignar la imagen sobre el rectángulo designado por el parámetro de lpBounds .(Esta imagen puede ser sesgada o estar encendida estableciendo la transformación universal en el dispositivo de salida antes de llamar a PlayMetaFile.) Los puntos a lo largo de los bordes del rectángulo se incluyen en la imagen.Imagen de metarchivo mejorado puede ser recortada definiendo la zona de recorte en el dispositivo de salida antes de reproducir el metarchivo mejorado.

Si un metarchivo mejorado contiene una tabla opcional, una aplicación puede lograr colores coherentes colocando una paleta de colores del dispositivo de salida antes de llamar a la segunda versión de PlayMetaFile.para recuperar la paleta opcional, utilice la función de GetEnhMetaFilePaletteEntries Windows.Un metarchivo mejorado se puede incrustar en un metarchivo mejorado recién creado llamando a la segunda versión de PlayMetaFile y reproduciendo el metarchivo mejorado de origen en el contexto para el nuevo metarchivo mejorado.

Esta función conservan los estados del contexto del dispositivo de salida.Cualquier objeto creado pero no eliminado en el metarchivo mejorado es eliminado por esta función.Para detener esta función, una aplicación puede llamar a la función de CancelDC Windows desde otro subproceso para finalizar la operación.en este caso, la función devuelve cero.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía

CancelDC

GetEnhMetaFileHeader

GetEnhMetaFilePaletteEntries

SetWorldTransform

PlayMetaFile

PlayEnhMetaFile

PlayMetaFile