Función CreateMetaFileA (wingdi.h)

Artículo
03/04/2024

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

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 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 la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Donde los argumentos de texto deben usar caracteres Unicode, use la función CreateMetaFile 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 metarchivos de formato Windows. 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 las funciones de salida de GDI en un metarchivo de formato Windows. No se puede usar con funciones de consulta GDI como GetTextColor. Cuando el contexto del dispositivo se usa 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 en caso contrario. Cuando se selecciona un objeto mediante la función SelectObject , solo se registra una copia del objeto. El objeto todavía pertenece a la aplicación.

Para crear un metarchivo de formato Windows escalable, 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
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