CDC::PlayMetaFile 

BOOL PlayMetaFile ( HMETAFILE hMF );

BOOL PlayMetaFile ( HENHMETAFILE hEnhMetaFile, Operador LPCRECT lpBounds );

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0.

Parâmetros

hMF

Identifica o metarquivo a ser jogado.

hEnhMetaFile

Identifica o metarquivo avançado.

lpBounds

Aponta para uma estrutura RECT ou um objeto CRect que contém as coordenadas do Retangular delimitador usado para exibir a imagem. As coordenadas são especificadas nas unidades lógicas.

Observações

Reproduz o conteúdo do metarquivo especificado no contexto de dispositivo. O metarquivo pode ser jogado qualquer número de vezes.

O segundo versão do PlayMetaFile exibe a imagem armazenada no metarquivo aprimorado-Formatarar determinado. Quando um aplicativo chama o segundo versão do PlayMetaFile, Windows usa o quadro de imagem no cabeçalho-metarquivo aprimorado para mapear a imagem para o Retangular apontado pelo parâmetro lpBounds . (Esta imagem pode ser sheared ou girada por configuração a Transformarar de mundo no dispositivo de saída antes de chamar PlayMetaFile.) Pontos ao longo das bordas do retângulo são incluídos na imagem. Uma imagem de metarquivo avançado pode ser cortada, definindo o região de recorte no dispositivo de saída antes de jogar o metarquivo avançado.

Se um metarquivo avançado contiver uma paleta opcional, um aplicativo pode obter cores consistentes, configurando uma paleta de cores no dispositivo de saída antes de chamar o segundo versão do PlayMetaFile. Para recuperar a paleta opcional, use o :: GetEnhMetaFilePaletteEntries função. Um metarquivo avançado pode ser incorporado em um metarquivo recém-criado, chamando o segundo versão do PlayMetaFile e jogando o metarquivo aprimorado de origem no contexto de dispositivo para o metarquivo avançado novo.

Os Estados do contexto de dispositivo de saída são preservados por essa função. Qualquer objeto criado mas não excluídos no metarquivo avançado é excluído por essa função. Para parar esta função, um aplicativo pode chamar o :: CancelDC função de outro thread para finalizar a operação. Neste caso, a função retorna zero.

Visão geral do CDCMembros de classe | Gráfico de hierarquia

See Also    ::CancelDC, ::GetEnhMetaFileHeader, ::GetEnhMetaFilePaletteEntries, ::SetWorldTransform, ::PlayMetaFile, ::PlayEnhMetaFile, ::PlayMetaFile

Index