Função CreateMetaFileA (wingdi.h)
A função CreateMetaFile cria um contexto de dispositivo para um metafile no formato Windows.
Sintaxe
HDC CreateMetaFileA(
[in] LPCSTR pszFile
);
Parâmetros
[in] pszFile
Um ponteiro para o nome do arquivo para o metafile no formato Windows a ser criado. Se esse parâmetro for NULL, o metafile no formato Windows será baseado em memória e seu conteúdo será perdido quando for excluído usando a função DeleteMetaFile.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será um identificador para o contexto do dispositivo para o metafile de formato do Windows.
Se a função falhar, o valor retornado será NULL.
Observações
Quando os argumentos de texto devem usar caracteres Unicode, use a função CreateMetaFile como uma função de caractere largo. Em que 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 metafile no formato Windows. Essa função dá suporte apenas a aplicativos baseados no Windows de 16 bits, listados em Windows-Format Metafiles. 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 metafile 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 VERDADEIRO 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 é gravada. O objeto ainda pertence ao aplicativo.
Para criar um metafile em formato windows escalonável, registre a saída de gráficos 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 metafilo do Windows pode ser dimensionado e renderizado em qualquer formato de dispositivo de saída definindo a origem do visor e as extensões da imagem antes de reproduzi-la.
Nota
O cabeçalho wingdi.h define CreateMetaFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | wingdi.h (inclua Windows.h) |
| biblioteca | Gdi32.lib |
| de DLL |
Gdi32.dll |