Função CreateMetaFileA (wingdi.h)

A função CreateMetaFile cria um contexto de dispositivo para um metarquivo no formato windows.

Sintaxe

HDC CreateMetaFileA(
  [in] LPCSTR pszFile
);

Parâmetros

[in] pszFile

Um ponteiro para o nome do arquivo para o metarquivo de formato do Windows a ser criado. Se esse parâmetro for NULL, o meta-arquivo de formato do Windows será baseado em memória e seu conteúdo será perdido quando for excluído usando a função DeleteMetaFile .

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o contexto do dispositivo para o metarquivo de formato do Windows.

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

Comentários

Quando os argumentos de texto devem usar caracteres Unicode, use a função CreateMetaFile como uma função de caractere largo. Quando os argumentos de texto devem usar caracteres do conjunto de caracteres do Windows, use essa função como uma função ANSI.

CreateMetaFile é uma função de meta-arquivo no formato Windows. Essa função dá suporte apenas a aplicativos baseados no Windows de 16 bits, que estão listados em Metarquivos de Formato do Windows. Ele não grava nem reproduz funções GDI, como PolyBezier, que não faziam parte do Windows de 16 bits.

O contexto do dispositivo criado por essa função pode ser usado para registrar funções de saída GDI em um metarquivo no formato windows. Ele não pode ser usado com funções de consulta GDI, como GetTextColor. Quando o contexto do dispositivo é usado com uma função de saída GDI, o valor retornado dessa função se torna TRUE se a função for registrada e FALSE caso contrário. Quando um objeto é selecionado usando a função SelectObject , apenas uma cópia do objeto é registrada. O objeto ainda pertence ao aplicativo.

Para criar um metarquivo escalonável no formato windows, registre a saída gráfica no modo de mapeamento de MM_ANISOTROPIC. O arquivo não pode conter funções que modificam a origem e as extensões do visor, nem pode conter funções dependentes do dispositivo, como a função SelectClipRgn . Depois de criado, o metarquivo do Windows pode ser dimensionado e renderizado para qualquer formato de dispositivo de saída definindo a origem do visor e as extensões da imagem antes de reproduzi-la.

Requisitos

Confira também

CloseMetaFile

CreateEnhMetaFile

Deletemetafile

GetTextColor

Funções de metarquivo

Visão geral de meta-arquivos

Selectcliprgn

Selectobject