Partilhar via


CMetaFileDC::CreateEnhanced

Cria um contexto de dispositivo para meta-arquivo de aprimorar- formato.

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

Parâmetros

  • pDCRef
    Identifica um dispositivo de referência para o metarquivo avançada.

  • lpszFileName
    Aponta para uma cadeia de caracteres NULL- finalizada.Especifica o nome de arquivo para que o metarquivo aprimorado é criado.Se esse parâmetro é NULO, o metarquivo é aprimorado memória base e seus conteúdos perderam quando o objeto é destruído ou quando a função do Win32 DeleteEnhMetaFile é chamada.

  • lpBounds
    Aponta para uma estrutura de dados de RECT ou um objeto de CRect que especifica as dimensões em unidades de HIMETRIC (em incrementos de .01 -) de imagem a ser armazenada em metarquivo avançada.

  • lpszDescription
    Aponta para uma cadeia de caracteres zero finalizada que especifica o nome do aplicativo que criou a imagem, bem como o título da imagem.

Valor de retorno

Uma alça de contexto de dispositivo para o metarquivo avançada, se com êxito; se não NULO.

Comentários

Esta C.C. pode ser usada para armazenar uma imagem independente.

O windows usa o dispositivo de referência identificado pelo parâmetro de pDCRef para registrar a resolução e unidades de dispositivo em que uma imagem exibida originalmente.Se o parâmetro de pDCRef é NULO, usa o dispositivo de exibição atual para referência.

Os membros da esquerda e à parte superior da estrutura de dados de RECT apontada pelo parâmetro de lpBounds devem ser menor do que os membros da direita e inferior, respectivamente.Os pontos ao longo das bordas do retângulo são incluídos na imagem.Se lpBounds é NULO, a interface de dispositivo (GDI) gráficos calcula as dimensões do retângulo menor que pode incluir a imagem desenhada pelo aplicativo.O parâmetro de lpBounds deve ser fornecido sempre que possível.

A cadeia de caracteres apontada pelo parâmetro de lpszDescription deve conter um caractere nulo entre o nome do aplicativo e o nome de imagem e deve finalizar com dois caracteres nulos — por exemplo, “do editor de elementos gráficos XYZ \ 0Bald Eagle \ 0 \ 0 \ 0”, onde representa o caractere nulo.Se lpszDescription é NULO, não há nenhuma entrada correspondente no cabeçalho de aprimorar- metarquivo.

Os aplicativos usam dc. criada por essa função para armazenar uma imagem de gráfico em meta-arquivo avançada.O identificador que identifica esta C.C. pode ser passada para qualquer função do GDI.

Depois que um aplicativo armazena uma imagem em meta-arquivo avançada, pode exibir a imagem em qualquer dispositivo de saída chamando a função de CDC::PlayMetaFile .Para exibir a imagem, o windows usam o retângulo apontada pelo parâmetro de lpBounds e dados de resolução do dispositivo de referência para dimensionar e posicionar a imagem.O contexto de dispositivo retornado por essa função contém os mesmos atributos padrão associados com qualquer novo C.C.

Os aplicativos devem usar a função do Win32 GetWinMetaFileBits para converter meta-arquivo aprimorado para o formato mais antiga do metarquivo do windows.

O nome de arquivo para o metarquivo avançada deve usar a extensão de .EMF.

Requisitos

Cabeçalho: afxext.h

Consulte também

Referência

Classe de CMetaFileDC

Gráfico de hierarquia

CMetaFileDC::CloseEnhanced

CDC::PlayMetaFile

CloseEnhMetaFile

DeleteEnhMetaFile

GetEnhMetaFileDescription

GetEnhMetaFileHeader

GetWinMetaFileBits

PlayEnhMetaFile