Función PlayEnhMetaFile (wingdi.h)

Artículo
08/27/2023

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