CMetaFileDC::CreateEnhanced
Cria um contexto de dispositivo para um metarquivo avançado formato.
BOOL CreateEnhanced(
CDC* pDCRef,
LPCTSTR lpszFileName,
LPCRECT lpBounds,
LPCTSTR lpszDescription
);
Parâmetros
pDCRef
Identifica um dispositivo de referência para metarquivo avançado.lpszFileName
Aponta para uma seqüência de caracteres terminada com caractere nulo.Especifica o nome de arquivo para o metarquivo a ser criado.Se esse parâmetro for NULO, metarquivo avançado é memória com base e seu Sumário perdido quando o objeto é destruído ou quando o Win32 DeleteEnhMetaFile função é chamada.lpBounds
Aponta para um RECT estrutura de dados ou um CRect objeto que especifica as dimensões em HIMETROunidades de (em incrementos de 0,01 milímetro) da imagem a ser armazenado no metarquivo avançado.lpszDescription
Aponta para uma seqüência de caracteres terminada em zero que especifica o nome do aplicativo que criou a imagem, bem sistema autônomo título da imagem.
Valor de retorno
Um identificador de contexto de dispositivo no metarquivo avançado, se for bem-sucedida; caso contrário, NULO.
Comentários
Este controlador de domínio pode ser usado para armazenar uma imagem independente de dispositivo.
Windows usa o dispositivo de referência identificado pelo pDCRef parâmetro para registrar a resolução e unidades do dispositivo no qual uma imagem aparecia originalmente. Se o pDCRef o parâmetro é NULO, ele usa dispositivo de vídeo corrente para referência.
Os membros esquerdos e superior a RECT estrutura de dados apontado pela lpBounds o parâmetro deve ser menor do que os membros da direita e inferior, respectivamente. Pontos ao longo das bordas do retângulo são incluídos na imagem.If lpBounds é NULO, a interface gráfica de dispositivo (GDI) calcula as dimensões da menor retângulo que pode colocar a Figura desenhada pelo aplicativo.The lpBounds parâmetro deve ser fornecido quando possível.
A seqüência de caracteres apontada pelo lpszDescriptionparâmetro deve conter um caractere nulo entre o nome do aplicativo e o nome da imagem e deve terminar com dois caracteres nulos — por exemplo, "XYZ Graphics Editor\0Bald Eagle\0\0," onde \0 representa o caractere nulo. If lpszDescription é NULO, não há nenhuma entrada correspondente no cabeçalho do metarquivo avançado.
Os aplicativos usam o controlador de domínio criado por essa função para armazenar uma imagem gráfica em um metarquivo avançado.O identificador identificando esse controlador de domínio pode ser passado para qualquer função GDI.
Depois que um aplicativo armazena uma imagem em um metarquivo avançado, ele pode exibir a figura em qualquer dispositivo de saída chamando o CDC::PlayMetaFile função. Ao exibir a imagem, o Windows usa o retângulo apontado pelo lpBounds parâmetro e os dados de resolução do dispositivo de referência para posicionar e dimensionar a imagem. O contexto de dispositivo retornado por essa função contém os atributos padrão mesmo associados a qualquer novo controlador de domínio.
Os aplicativos devem usar o Win32 GetWinMetaFileBits função para converter um metarquivo avançado para o formato WMF mais antigo.
O nome de arquivo para metarquivo avançado deve usar a extensão .EMF.
Requisitos
Cabeçalho: afxext.h