CDC::AbortDoc
停止当前打印作业并清除应用程序的设备编写的内容,因为最后一次调用 StartDoc 成员函数。
int AbortDoc( );
返回值
大于或等于0的值,如果成功或负值,如果错误。下面列出了常见错误值及其含义:
SP_ERROR 常规错误。
SP_OUTOFDISK 没有足够的磁盘空间为后台打印当前可用的,因此,没有其他空间不会变得可用。
SP_OUTOFMEMORY 没有足够的内存为后台打印可用。
SP_USERABORT 用户通过版式监督停止该工作。
备注
此成员函数替换 ABORTDOC 打印机转义。
应使用AbortDoc 停止以下操作:
使用 SetAbortProc,不指定中止功能的打印操作。
未达到的第一个 NEWFRAME 或 NEXTBAND 转义的打印操作调用。
如果应用程序在遇到输出错误或取消的打印操作,它不能尝试停止操作使用选件类 CDC的 EndDoc 或 AbortDoc 成员函数。GDI在返回false值之前自动终止操作。
如果应用程序显示对话框允许用户取消打印操作,则必须在销毁对话框之前调用 AbortDoc。
如果版式监督用于启动打印作业时,调用 AbortDoc 清除整个后台打印工作—打印机没有接收。如果版式监督未使用启动打印作业,则数据可能会被发送到打印机,在 AbortDoc 调用之前。在这种情况下,打印机驱动程序将重新设置打印机(如果可能)和关闭打印作业。
示例
为 CDC::StartDoc参见示例。
要求
Header: afxwin.h