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