CMetaFileDC::CreateEnhanced

BOOL CreateEnhanced ( CDC * pDCRef, LPCTSTR lpszFileName, Operador LPCRECT lpBounds, LPCTSTR lpszDescription );

Valor de retorno

Um identificador de contexto de dispositivo para o metarquivo avançado, se bem-sucedida; caso contrário NULL.

Parâmetros

pDCRef

Identifica um dispositivo de referência para o metarquivo avançado.

lpszFileName

Aponta para uma Cadeia de caracteres terminada por caractere nulo. Especifica o nome do arquivo para o metarquivo avançado a ser criado. Se este parâmetro for NULL, o metarquivo avançado é memória com base e seu conteúdo perdido quando o objeto é destruído ou quando a :: DeleteEnhMetaFile função é chamado.

lpBounds

Aponta para uma estrutura de dados RECT ou um objeto CRect que especifica as dimensões em unidades HIMÉTRICAS (em incrementos de. 01-milímetro) da imagem a ser armazenado na metarquivo avançado.

lpszDescription

Aponta para uma seqüência de caracteres zero-terminated que especifica o nome do aplicativo que criou a imagem, bem como título da imagem.

Observações

Cria um contexto de dispositivo para um metarquivo aprimorado-Formatarar. Este DC pode ser usado para armazenar uma imagem de independente de dispositivo.

O Windows usa o dispositivo de referência identificado pelo parâmetro da pDCRef para registrar a resolução e unidades do dispositivo no qual uma imagem apareceu originalmente. Se o pDCRef parâmetro é NULL, ele usa o atual dispositivo exibir para referência.

Os membros de esquerda e superiores da estrutura de dados RECT apontado pelo parâmetro lpBounds devem ser menores do que o direito e inferior Membros, respectivamente. Pontos ao longo das bordas do retângulo são incluídos na imagem. Se lpBounds for Nulo, a interface dispositivo gráfico (GDI) calcula as dimensões do retângulo menor que pode colocar a imagem desenhada pelo aplicativo. O parâmetro lpBounds deve ser fornecido sempre que possível.

Seqüência de caracteres apontada pelo lpszDescription parâmetro deve conter um caractere nulo entre o nome do aplicativo e o nome de imagem e deve encerrar com null dois caracteres — por exemplo, "XYZ gráficos Editor\0Bald Eagle\0\0," onde \0 representa o caractere nulo. Se lpszDescription for NULL, não há nenhuma entrada correspondente no cabeçalho-metarquivo aprimorado.

Aplicativos usam o controlador de domínio criado por essa função para armazenar uma imagem de elementos gráficos em um metarquivo avançado. O identificador que identifica este DC pode ser passado para qualquer função GDI.

Depois que um aplicativo armazena uma imagem em um metarquivo avançado, ele pode exibir a imagem em qualquer dispositivo de saída chamando a função CDC:: PlayMetaFile . Ao exibir a imagem, o Windows usa o Retangular apontado pelo parâmetro lpBounds e os dados de resolução do dispositivo de referência para posicionar e dimensionar a imagem. O contexto para dispositivo retornado por essa função contém os mesmos atributos de padrão associados a qualquer novo controlador de domínio.

Os aplicativos devem usar o :: GetWinMetaFileBits função para converter um metarquivo avançado para o Formatarar de metarquivo do Windows mais antigo.

O nome do arquivo para o metarquivo avançado deve usar o.Extensão EMF.

Visão geral de CMetaFileDCMembros de classe | Gráfico de hierarquia

See Also   CMetaFileDC::CloseEnhanced, CDC::PlayMetaFile, ::CloseEnhMetaFile, ::DeleteEnhMetaFile, ::GetEnhMetaFileDescription, ::GetEnhMetaFileHeader, ::GetWinMetaFileBits, ::PlayEnhMetaFile

Index