Función SetWinMetaFileBits (wingdi.h)
La función SetWinMetaFileBits convierte un metarchivo del formato anterior de Windows al nuevo formato mejorado y almacena el nuevo metarchivo en memoria.
Sintaxis
HENHMETAFILE SetWinMetaFileBits(
[in] UINT nSize,
[in] const BYTE *lpMeta16Data,
[in] HDC hdcRef,
[in] const METAFILEPICT *lpMFP
);
Parámetros
[in] nSize
Tamaño, en bytes, del búfer que contiene el metarchivo de formato Windows.
[in] lpMeta16Data
Puntero a un búfer que contiene los datos del metarchivo de formato Windows. (Se supone que los datos se obtuvieron mediante la función GetMetaFileBitsEx o GetWinMetaFileBits ).
[in] hdcRef
Identificador de un contexto de dispositivo de referencia.
[in] lpMFP
Puntero a una estructura METAFILEPICT que contiene el tamaño sugerido de la imagen de metarchivo y el modo de asignación que se usó cuando se creó la imagen.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un identificador para un metarchivo mejorado basado en memoria.
Si la función no se realiza correctamente, el valor devuelto es NULL.
Comentarios
Windows usa los datos de resolución del contexto del dispositivo de referencia y los datos de la estructura METAFILEPICT para escalar una imagen. Si el parámetro hdcRef es NULL, el sistema usa datos de resolución para el dispositivo de salida actual. Si el parámetro lpmfp es NULL, el sistema usa el modo de asignación de MM_ANISOTROPIC para escalar la imagen de modo que se ajuste a toda la superficie del dispositivo. No se utiliza el miembro hMF de la estructura METAFILEPICT .
Cuando la aplicación ya no necesite el identificador de metarchivo mejorado, debe eliminarlo llamando a la función DeleteEnhMetaFile .
El identificador devuelto por esta función se puede usar con otras funciones de metarchivo mejoradas.
Si el contexto del dispositivo de referencia no es idéntico al dispositivo en el que se creó originalmente el metarchivo, es posible que algunas funciones de GDI que usen unidades de dispositivo no dibujen correctamente la imagen.
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 |