CDC::PlayMetaFile
Executa o conteúdo de metarquivo especificado no contexto de 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çada.lpBounds
Os pontos a RECT estrutura ou um objeto de CRect 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 é com êxito; se não 0.
Comentários
O metarquivo pode ser executado qualquer número de vezes.
A segunda versão de PlayMetaFile exibe a imagem armazenada no metarquivo dado de aprimorar- formato. Quando um aplicativo chama a segunda versão de PlayMetaFile, o windows usam a moldura de retrato no cabeçalho de aprimorar- metarquivo para mapear a imagem no retângulo apontada pelo parâmetro de lpBounds . (Esta imagem pode ser cortada ou rotacionado definindo o mundo transformar no dispositivo de saída antes de chamar PlayMetaFile.) Os pontos ao longo das bordas do retângulo são incluídos na imagem. Uma imagem de aprimorar- metarquivo pode ser recortada definir a região recortada no dispositivo de saída antes de executar o metarquivo avançada.
Se meta-arquivo aprimorado contém uma paleta opcional, um aplicativo pode obter cores consistentes configurando uma paleta de cores no dispositivo de saída antes de chamar a segunda versão de PlayMetaFile. Para recuperar a paleta opcional, use a função do windows de GetEnhMetaFilePaletteEntries . Meta-arquivo aprimorado pode ser inserido em meta-arquivo aprimorado recém-criado chamando a segunda versão de PlayMetaFile e executando o metarquivo aprimorado origem no contexto de dispositivo para o novo metarquivo avançada.
Os estados de contexto do dispositivo de saída são mantidos por essa função. Qualquer objeto criado mas não excluído no metarquivo aprimorado é excluído por essa função. Para parar essa função, um aplicativo pode chamar a função do windows de CancelDC de outro segmento para finalizar a operação. Em esse caso, retorna zero de função.
Requisitos
Cabeçalho: afxwin.h