CDC::AbortDoc

停止当前打印作业并清除应用程序的设备编写的内容,因为最后一次调用 StartDoc 成员函数。

int AbortDoc( );

返回值

大于或等于0的值,如果成功或负值,如果错误。 下面列出了常见错误值及其含义:

  • SP_ERROR 常规错误。

  • SP_OUTOFDISK 没有足够的磁盘空间为后台打印当前可用的,因此,没有其他空间不会变得可用。

  • SP_OUTOFMEMORY 没有足够的内存为后台打印可用。

  • SP_USERABORT 用户通过版式监督停止该工作。

备注

此成员函数替换 ABORTDOC 打印机转义。

应使用AbortDoc 停止以下操作:

  • 使用 SetAbortProc,不指定中止功能的打印操作。

  • 未达到的第一个 NEWFRAMENEXTBAND 转义的打印操作调用。

如果应用程序在遇到输出错误或取消的打印操作,它不能尝试停止操作使用选件类 CDCEndDocAbortDoc 成员函数。 GDI在返回false值之前自动终止操作。

如果应用程序显示对话框允许用户取消打印操作,则必须在销毁对话框之前调用 AbortDoc

如果版式监督用于启动打印作业时,调用 AbortDoc 清除整个后台打印工作—打印机没有接收。 如果版式监督未使用启动打印作业,则数据可能会被发送到打印机,在 AbortDoc 调用之前。 在这种情况下,打印机驱动程序将重新设置打印机(如果可能)和关闭打印作业。

示例

CDC::StartDoc参见示例。

要求

Header: afxwin.h

请参见

参考

CDC 类

层次结构图

CDC::StartDoc

CDC::EndDoc

CDC::SetAbortProc