CDC::AbortDoc

Artigo
06/10/2015

Finaliza o trabalho de impressão atual e apaga tudo que o aplicativo tenha escrito para o dispositivo desde a última chamada para a função de membro de StartDoc .

int AbortDoc( );

Valor de retorno

Um valor maior ou igual a 0 se com êxito, ou um valor negativo se um erro ocorrer. A lista a seguir mostra valores comuns de erro e seus significados:

Erro de gerais deSP_ERROR .
SP_OUTOFDISK não espaço suficiente em disco está disponível no momento para rolar, e não será mais espaço disponível.
SP_OUTOFMEMORY memória suficiente não está disponível para rolar.
O usuário deSP_USERABORT finalizou funciona através do gerenciador de impressão.

Comentários

Essa função de membro substitui o escape de impressora de ABORTDOC .

AbortDoc deve ser usado para finalizar o seguinte:

Operações de impressão que não especificam uma função de abort SetAbortProcusando.
Operações de impressão que não alcançaram ainda chamada do primeiro vazamento de NEWFRAME ou de NEXTBAND .

Se um aplicativo encontra um erro de impressão ou uma operação de cópia cancelado, não deve tentar finalizar a operação usando as funções de membro de EndDoc ou de AbortDoc da classe CDC. GDI encerra automaticamente a operação antes de retornar o valor de erro.

Se o aplicativo exibe uma caixa de diálogo para permitir que o usuário cancele a operação de cópia, deve chamar AbortDoc antes de destruir a caixa de diálogo.

Se o gerenciador de impressão foi usado para iniciar o trabalho de impressão, chame AbortDoc apaga os trabalhos inteiros de spool — a impressora não recebe nada. Se o gerenciador de impressão não foi usado para iniciar o trabalho de impressão, os dados podem ter sido enviado para a impressora antes que AbortDoc foi chamado. Em esse caso, o driver de impressora redefiniria a impressora (quando possível) e será fechada o trabalho de impressão.