Поделиться через


CDC::AbortDoc

Завершает текущее задание печати и стирает все приложение для добавления записей на устройство с момента последнего вызова StartDoc к функции-члену.

int AbortDoc( );

Возвращаемое значение

Значение, большее или равное 0 в случае успешного или отрицательное значение, если произошла ошибка.В следующем списке приведены общие значения ошибок и их значения.

  • Ошибка общих SP_ERROR.

  • SP_OUTOFDISK Недостаточно места на диске в настоящее время доступны для наматывать, и больше места не станут доступными.

  • SP_OUTOFMEMORY Недостаточно памяти доступно для наматывать.

  • Пользователь SP_USERABORT завершении задания печати посредством диспетчера.

Заметки

Это функция-член заменяет избежать принтера ABORTDOC.

AbortDoc должно использоваться для выполнения следующего:

  • Операции печати, которые не указывают функции прерывания с помощью SetAbortProc.

  • Операции печати, которые еще не достигали их первый вызов NEWFRAME или escape-последовательности NEXTBAND.

Если приложение встречает ошибку печати или отменена операция печати, оно не должно попытаться завершить операцию с помощью функций-членов EndDoc или AbortDoc класса CDC.GDI операция завершается автоматически перед возвратом значения ошибки.

Если приложение отображает диалоговое окно, чтобы позволить пользователю для отмены операции печати, он должен вызвать AbortDoc перед разрушать диалоговое окно.

Если диспетчер печати использовался для запуска задания печати, то при вызове AbortDoc стирает все задание spool — принтер не возвращает никаких действий.Если диспетчер печати не использовался для запуска задания печати, данные могут быть отправлены на принтер, прежде чем AbortDoc было вызываются.В этом случае драйвер принтера сброситьTm бы принтер (если возможно) и закрытьTm бы задание печати.

Пример

См. пример для CDC::StartDoc.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

Диаграмма иерархии

CDC::StartDoc

CDC::EndDoc

CDC::SetAbortProc