释义 |
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 |