Método Metafile::EmfToWmfBits (gdiplusheaders.h)

Artículo
08/24/2023

Convierte un metarchivo de formato mejorado en un metarchivo de formato de metarchivo de Windows (WMF) y almacena los registros convertidos en un búfer especificado.

Sintaxis

UINT EmfToWmfBits(
  [in]           HENHMETAFILE hemf,
  [in]           UINT         cbData16,
  [out]          LPBYTE       pData16,
  [in, optional] INT          iMapMode,
  [in, optional] INT          eFlags
);

Parámetros

[in] hemf

Tipo: HENHMETAFILE

Controle el metarchivo de formato mejorado que se va a convertir.

[in] cbData16

Tipo: UINT

Entero sin signo que especifica el número de bytes del búfer al que apunta el parámetro pData16 .

[out] pData16

Tipo: LPBYTE

Puntero a un búfer que recibe los registros convertidos. Si pData16 es NULL, Metafile::EmfToWmfBits devuelve el número de bytes necesarios para almacenar los registros de metarchivo convertidos.

[in, optional] iMapMode

Tipo: INT

Opcional. Especifica el modo de asignación que se va a usar en el metarchivo convertido. Para obtener una lista de los posibles modos de asignación, consulte SetMapMode. El valor predeterminado es MM_ANISOTROPIC.

[in, optional] eFlags

Tipo: EmfToWmfBitsFlags

Opcional. Elemento de la enumeración EmfToWmfBitsFlags que especifica las opciones para la conversión. El valor predeterminado es EmfToWmfBitsFlagsDefault.

Valor devuelto

Tipo: UINT

Si el método se ejecuta correctamente y el puntero del búfer es NULL, el valor devuelto es el número de bytes necesarios para almacenar los registros convertidos. Si el método se ejecuta correctamente y el puntero del búfer es un puntero válido, el valor devuelto es el tamaño de los datos del metarchivo en bytes. Si se produce un error en el método, el valor devuelto es cero.

Comentarios

Al llamar a Metafile::EmfToWmfBits para determinar el tamaño del búfer necesario, debe pasar el mismo valor para eFlags que pase más adelante al llamar a Metafile::EmfToWmfBits para realizar la conversión. De lo contrario, el tamaño devuelto por la primera llamada a Metafile::EmfToWmfBits será incorrecto.

Este método no puede convertir metarchivos de tipo EmfTypeEmfPlusOnly. Si usa este método para convertir un metarchivo de tipo EmfTypeEmfPlusDual, los registros de metarchivo mejorado (EMF) de ese metarchivo se convierten, pero los registros EMF+ no se convierten.

Este método convierte un metarchivo mejorado en un metarchivo WMF para que su imagen se pueda mostrar en una aplicación que reconozca el formato anterior.

El método Metafile::EmfToWmfBits no invalida el identificador de metarchivo mejorado. Llame a la función DeleteEnhMetaFile para liberar el identificador cuando ya no sea necesario.

Para crear un metarchivo WMF escalable, especifique MM_ANISOTROPIC como parámetro iMapMode .

Ejemplos

En el ejemplo siguiente se convierte un metarchivo de formato mejorado en un metarchivo WMF. El último parámetro pasado a Metafile::EmfToWmfBits especifica que el metarchivo de formato mejorado se inserta como comentario en el metarchivo convertido.

// Construct a Metafile object from an existing EMF disk file.
Metafile myMetafile(L"SourceMetafile.emf");

// Get a handle to the EMF metafile.
HENHMETAFILE hEmf = myMetafile.GetHENHMETAFILE();

// Determine the size of the buffer that will receive the converted records.
UINT size = Metafile::EmfToWmfBits(
   hEmf, 
   0, 
   NULL,
   MM_ANISOTROPIC,
   EmfToWmfBitsFlagsEmbedEmf);

// Allocate a buffer to receive the converted records.
BYTE* buffer = new BYTE[size];

// Convert the EMF records to WMF records.
INT convertedSize = Metafile::EmfToWmfBits(
   hEmf, 
   size,
   buffer, 
   MM_ANISOTROPIC,
   EmfToWmfBitsFlagsEmbedEmf);

// Get a handle to the converted metafile.
HMETAFILE hmf = SetMetaFileBitsEx(size, buffer);

// Write the WMF metafile to a disk file.
CopyMetaFile(hmf, TEXT("ConvertedMetafile.wmf"));

DeleteMetaFile(hmf);
DeleteEnhMetaFile(hEmf);
delete[] buffer;

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll