Função SetWinMetaFileBits (wingdi.h)

Artigo
03/04/2024

A função SetWinMetaFileBits converte um metarquivo do formato mais antigo do Windows para o novo formato aprimorado e armazena o novo meta-arquivo na memória.

Sintaxe

HENHMETAFILE SetWinMetaFileBits(
  [in] UINT               nSize,
  [in] const BYTE         *lpMeta16Data,
  [in] HDC                hdcRef,
  [in] const METAFILEPICT *lpMFP
);

Parâmetros

[in] nSize

O tamanho, em bytes, do buffer que contém o metarquivo no formato windows.

[in] lpMeta16Data

Um ponteiro para um buffer que contém os dados de metarquivo no formato do Windows. (Supõe-se que os dados foram obtidos usando a função GetMetaFileBitsEx ou GetWinMetaFileBits .)

[in] hdcRef

Um identificador para um contexto de dispositivo de referência.

[in] lpMFP

Um ponteiro para uma estrutura METAFILEPICT que contém o tamanho sugerido da imagem de metarquivo e o modo de mapeamento que foi usado quando a imagem foi criada.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para um meta-arquivo aprimorado baseado em memória.

Se a função falhar, o valor retornado será NULL.

Comentários

O Windows usa os dados de resolução do contexto do dispositivo de referência e os dados na estrutura METAFILEPICT para dimensionar uma imagem. Se o parâmetro hdcRef for NULL, o sistema usará dados de resolução para o dispositivo de saída atual. Se o parâmetro lpmfp for NULL, o sistema usará o modo de mapeamento MM_ANISOTROPIC para dimensionar a imagem para que ela se ajuste a toda a superfície do dispositivo. O membro hMF da estrutura METAFILEPICT não é usado.

Quando o aplicativo não precisar mais do identificador de meta-arquivo aprimorado, ele deverá excluí-lo chamando a função DeleteEnhMetaFile .

O identificador retornado por essa função pode ser usado com outras funções enhanced-metafile.

Se o contexto do dispositivo de referência não for idêntico ao dispositivo no qual o metarquivo foi criado originalmente, algumas funções GDI que usam unidades de dispositivo poderão não desenhar a imagem corretamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll