CDC::AbortDoc
int AbortDoc();
返回值:
如果成功,则大于或等于零;如果出现错误,则为负值。
下表列出普通错误值及其含义:
SP_ERROR
一般错误
SP_OUTOFDISK
当前缓冲池没有足够的磁盘空间,并且没有更多的空间可用。
SP_OUTOFMEMORY
没有足够的内存用作缓冲池。
SP_USERABORT
用户通过打印管理器终止作业。
说明:
终止当前打印任务,擦掉自上次调用StartDoc成员函数以来应用写入设备的任何内容。
这个成员函数代替ABORTDOC打印机跳离。
AbortDoc应该用于终止以下:
・
没有用SetAbortDoc指定失败功能的打印操作。
・
未到达首次NEWFRAME或NEXTBAND跳离调用的打印操作。
如果应用遇到打印错误或取消打印操作,它必须不试图使用CDC类的EndDoc或AbortDoc成员函数终止操作。在返回错误值之前,GDI自动终止操作。
如果应用显示对话框,允许用户取消打印操作,它必须在销毁这个对话框之前调用AbortDoc。如果使用打印管理器启动打印任务,调用AbortDoc会擦除全部缓冲池作业──打印机接收不到内容。如果使用打印管理器启动打印任务,则在AbortDoc调用之前数据可能已经送到打印机。这时打印驱动程序必须重设打印机(可能时)并关闭打印作业。
请参阅:
CDC::StartDoc
,
CDC::EndDoc
,
CDC::SetAbortProc