CDC::PlayMetaFile 

BOOL PlayMetaFile ( HMETAFILE hMF );

BOOL PlayMetaFile ( HENHMETAFILE hEnhMetaFile, LPCRECT lpBounds );

Valor devuelto

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

Parámetros

hMF

Identifica el metarchivo de reproducirse.

hEnhMetaFile

Identifica el metarchivo mejorado.

lpBounds

Apunta a una estructura RECT o un objeto CRect que contiene las coordenadas del rectángulo delimitador que se utiliza para mostrar la imagen. Las coordenadas se especifican en unidades lógicas.

Observaciones

Reproduce el contenido del metarchivo especificado en el contexto de dispositivo. Los metarchivos pueden jugar cualquier número de veces.

La segunda versión del PlayMetaFile muestra la imagen almacenada en el metarchivo mejorado formato determinado. Cuando una aplicación llama la segunda versión del PlayMetaFile, Windows utiliza el marco de imagen en el encabezado de metarchivo mejorado para asignar la imagen en el rectángulo indicado por el parámetro lpBounds . (Esta imagen puede ser esquilada o rotada estableciendo la transformación del mundo en el dispositivo de salida antes de llamar a PlayMetaFile.) En la imagen se incluyen puntos a lo largo de los bordes del rectángulo. Una imagen de metarchivo mejorado puede recortarse mediante la definición de la región de recorte en el dispositivo de salida antes de jugar el metarchivo mejorado.

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

Los Estados del contexto de dispositivo de salida se conservan por esta función. Cualquier objeto creado pero no se eliminan en el metarchivo mejorado es eliminado por esta función. Para detener esta función, una aplicación puede llamar a la :: CancelDC función desde otro subproceso para terminar la operación. En este caso, la función devuelve cero.

Visió&n General de CDC |nbsp; Miembros de clase | Diagrama de jerarquía

See Also    ::CancelDC, ::GetEnhMetaFileHeader, ::GetEnhMetaFilePaletteEntries, ::SetWorldTransform, ::PlayMetaFile, ::PlayEnhMetaFile, ::PlayMetaFile

Index