CDC::PlayMetaFile
Reproduz o Sumário do metarquivo especificado no contexto do dispositivo.
BOOL PlayMetaFile(
HMETAFILE hMF
);
BOOL PlayMetaFile(
HENHMETAFILE hEnhMetaFile,
LPCRECT lpBounds
);
Parâmetros
hMF
Identifica o metarquivo a ser executado.hEnhMetaFile
Identifica o metarquivo avançado.lpBounds
Aponta para um RECT estrutura ou uma CRect objeto que contém as coordenadas do retângulo delimitador usado para exibir a imagem. As coordenadas são especificadas em unidades lógicas.
Valor de retorno
Diferente de zero se a função for bem-sucedida; caso contrário, 0.
Comentários
O metarquivo pode ser executado várias vezes.
A segunda versão do PlayMetaFile Exibe a imagem armazenada no metarquivo avançado formato determinado. Quando um aplicativo chama a segunda versão do PlayMetaFileWindows use o quadro de imagem no cabeçalho do metarquivo avançado para mapear a imagem até o retângulo apontado pela lpBounds parâmetro. (Esta imagem pode ser distorcida ou girada por configuração a transformação do 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 a região de recorte no dispositivo de saída para jogar o metarquivo avançado.
Se um Metarquivo Avançado contiver uma paleta opcional, um aplicativo pode obter cores consistentes, definindo uma paleta de cores no dispositivo de saída antes de chamar a segunda versão do PlayMetaFile. Para recuperar a paleta opcional, use o GetEnhMetaFilePaletteEntries Função do Windows.Um metarquivo avançado pode ser incorporado em um metarquivo avançado recém-criado chamando a segunda versão do PlayMetaFile e reproduzir o metarquivo aprimorado de fonte para o contexto de dispositivo para o novo metarquivo aprimorado.
Os estados do contexto de dispositivo de saída são preservados por essa função.Qualquer objeto criado mas não excluído no metarquivo avançado é excluído por essa função.Para interromper essa função, um aplicativo pode telefonar o CancelDC Função do Windows de outro segmento para terminar a operação.Nesse caso, a função retornará zero.
Requisitos
Cabeçalho: afxwin.h