Función CreateMetaFileA (wingdi.h)

La función CreateMetaFile crea un contexto de dispositivo para un metarchivo de formato Windows.

Nota Esta función solo se proporciona por 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 CreateEnhMetaFile.

 

Sintaxis

HDC CreateMetaFileA(
  [in] LPCSTR pszFile
);

Parámetros

[in] pszFile

Puntero al nombre de archivo del metarchivo de formato Windows que se va a crear. Si este parámetro es NULL, el metarchivo de formato Windows se basa en la memoria y su contenido se pierde cuando se elimina mediante la función DeleteMetaFile.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador del contexto del dispositivo para el metarchivo de formato Windows.

Si se produce un error en la función, el valor devuelto es NULL.

Observaciones

Donde los argumentos de texto deben usar caracteres Unicode, use el CreateMetaFile función como una función de caracteres anchos. Donde los argumentos de texto deben usar caracteres del conjunto de caracteres de Windows, use esta función como una función ANSI.

CreateMetaFile es una función de metarchivo de formato Windows. Esta función solo admite aplicaciones basadas en Windows de 16 bits, que se enumeran en Windows-Format Metfiles. No graba ni reproduce funciones GDI como PolyBezier, que no formaban parte de Windows de 16 bits.

El contexto del dispositivo creado por esta función se puede usar para registrar funciones de salida de GDI en un metarchivo de formato Windows. No se puede usar con funciones de consulta GDI como GetTextColor. Cuando se usa el contexto del dispositivo con una función de salida GDI, el valor devuelto de esa función se convierte en TRUE si la función se registra y FALSE de lo contrario. Cuando se selecciona un objeto mediante la función SelectObject de , solo se registra una copia del objeto. El objeto todavía pertenece a la aplicación.

Para crear un metarchivo escalable de formato Windows, registre la salida de gráficos en el modo de asignación de MM_ANISOTROPIC. El archivo no puede contener funciones que modifiquen el origen y las extensiones de la ventanilla, ni pueden contener funciones dependientes del dispositivo, como la función SelectClipRgn. Una vez creado, el metarchivo de Windows se puede escalar y representar en cualquier formato de dispositivo de salida definiendo el origen de la ventanilla y las extensiones de la imagen antes de reproducirla.

Nota

El encabezado wingdi.h define CreateMetaFile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wingdi.h (incluya Windows.h)
biblioteca de	Gdi32.lib
DLL de	Gdi32.dll

Consulte también

CloseMetaFile

CreateEnhMetaFile

DeleteMetaFile

GetTextColor

funciones de metarchivo de

introducción a los metarchivos de

selectClipRgn

SelectObject