Compartilhar via


CDC::AbortDoc

Termina o trabalho de impressão corrente e apaga tudo o que o aplicativo tem gravados no dispositivo desde a última telefonar para o StartDocfunção de membro .

int AbortDoc( );

Valor de retorno

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

  • SP_ERROR   Erro geral.

  • SP_OUTOFDISK   Não há espaço suficiente em disco é atualmente disponíveis para o spool, e não há mais espaço ficará disponível.

  • SP_OUTOFMEMORY   Não há memória suficiente está disponível para o spool.

  • SP_USERABORT   Usuário terminado o trabalho por meio do Gerenciador de impressão.

Comentários

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

AbortDoc deve ser usado para terminar o seguinte:

  • Imprimir operações que não especificam uma função de anulação usando SetAbortProc.

  • Imprimir operações que ainda não foi atingido sua primeira NEWFRAME or NEXTBAND escape telefonar.

Se um aplicativo encontrar um erro de impressão ou uma operação de impressão cancelada, ele não deve tentar terminar a operação usando o EndDoc or AbortDoc funções de membro de 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 cancelar a operação de impressão, ele deve telefonar AbortDoc antes de destruir a caixa de diálogo.

Se o Gerenciador de impressão foi usado para iniciar o trabalho de impressão, chamada AbortDoc apaga o spool todo trabalho — a impressora recebe nada.Se o Gerenciador de impressão não tiver sido usado para iniciar o trabalho de impressão, os dados talvez tenha sido enviados para a impressora antes de AbortDoc foi chamado.Nesse caso, o driver de impressora redefiniria com a impressora (quando for possível) e fechado o trabalho de impressão.

Exemplo

Consulte o exemplo para CDC::StartDoc.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::StartDoc

CDC::EndDoc

CDC::SetAbortProc

Outros recursos

Membros do CDC