Función PlayMetaFile (wingdi.h)

La función PlayMetaFile muestra la imagen almacenada en el metarchivo de formato Windows especificado en el dispositivo especificado.

Nota Esta función solo se proporciona para la compatibilidad con los metarchivos de formato Windows. Los metarchivos de formato mejorado proporcionan una funcionalidad superior y se recomiendan para las nuevas aplicaciones. La función correspondiente para un metarchivo de formato mejorado es PlayEnhMetaFile.

 

Sintaxis

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

Parámetros

[in] hdc

Identificador de un contexto de dispositivo.

[in] hmf

Identificador de un metarchivo de formato Windows.

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

Para convertir un metarchivo de formato Windows en un metarchivo de formato mejorado, use la función SetWinMetaFileBits .

Un metarchivo de formato Windows se puede reproducir varias veces.

Un metarchivo de formato Windows se puede incrustar en un segundo metarchivo de formato Windows llamando a la función PlayMetaFile y reproduciendo el metarchivo de origen en el contexto del dispositivo para el metarchivo de destino.

Esta función elimina cualquier objeto creado pero no eliminado en el metarchivo de formato Windows.

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.

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

Consulte también

CancelDC

Funciones de metarchivo

Introducción a los metarchivos

SetWinMetaFileBits