Función PlayEnhMetaFile (wingdi.h)
La función PlayEnhMetaFile muestra la imagen almacenada en el metarchivo de formato mejorado especificado.
Sintaxis
BOOL PlayEnhMetaFile(
[in] HDC hdc,
[in] HENHMETAFILE hmf,
[in] const RECT *lprect
);
Parámetros
[in] hdc
Identificador del contexto del dispositivo para el dispositivo de salida en el que aparecerá la imagen.
[in] hmf
Identificador del metarchivo mejorado.
[in] lprect
Puntero a una estructura RECT que contiene las coordenadas del rectángulo delimitador utilizado para mostrar la imagen. Las coordenadas se especifican en unidades lógicas.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Cuando una aplicación llama a la función PlayEnhMetaFile , el sistema usa el marco de imagen en el encabezado de metarchivo mejorado para asignar la imagen al rectángulo al que apunta el parámetro lpRect . (Esta imagen se puede escalar o girar estableciendo la transformación del mundo en el dispositivo de salida antes de llamar a PlayEnhMetaFile). Los puntos a lo largo de los bordes del rectángulo se incluyen en la imagen.
Se puede recortar una imagen de metarchivo mejorado si se define la zona de recorte en el dispositivo de salida antes de reproducir el metarchivo mejorado.
Si un metarchivo mejorado contiene una paleta opcional, una aplicación puede lograr colores coherentes configurando una paleta de colores en el dispositivo de salida antes de llamar a PlayEnhMetaFile. Para recuperar la paleta opcional, use la función GetEnhMetaFilePaletteEntries .
Un metarchivo mejorado se puede incrustar en un metarchivo mejorado recién creado llamando a PlayEnhMetaFile y reproduciendo el metarchivo mejorado de origen en el contexto del dispositivo para el nuevo metarchivo mejorado.
Esta función conserva los estados del contexto de dispositivo de salida. Esta función elimina cualquier objeto que se haya creado pero no eliminado del metarchivo mejorado.
Para detener esta función, una aplicación puede llamar a la función CancelDC desde otro subproceso para finalizar la operación. En este caso, la función devuelve FALSE.
Ejemplos
Para obtener un ejemplo, vea Abrir un metarchivo mejorado y Mostrar su contenido.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wingdi.h (incluye Windows.h) |
| Library | Gdi32.lib |
| Archivo DLL | Gdi32.dll |