CDC::AbortDoc
結束目前的列印工作並清除應用程式提供裝置時,因為最後一個呼叫將 StartDoc 成員函式的所有項目。
int AbortDoc( );
傳回值
大於或等於 0 的值,如果成功或負值,則會發生錯誤。 下列清單顯示常見錯誤值及其意義:
SP_ERROR 一般錯誤。
SP_OUTOFDISK 沒有足夠的磁碟空間供多工緩衝處理可用,,而且不再發生空間不會變成可用狀態。
SP_OUTOFMEMORY 沒有足夠的記憶體來多工緩衝處理可供使用。
SP_USERABORT 使用者透過列印管理員正在結束這個工作。
備註
此成員函式取代 ABORTDOC 印表機逸出。
應該用來AbortDoc 終止如下:
使用 SetAbortProc,不指定停駐點功能的列印作業。
未到達其第一 NEWFRAME 或 NEXTBAND 逸出呼叫的列印作業。
如果應用程式遇到的錯誤或已取消的列印作業,都不可以嘗試終止作業使用類別 CDC的 EndDoc 或 AbortDoc 成員函式。 GDI 在傳回錯誤值之前自動終止作業。
如果應用程式會顯示 對話方塊可讓使用者取消列印作業,必須在終結對話方塊之前呼叫 AbortDoc 。
如果列印管理員正在使用開始列印工作,呼叫 AbortDoc 清除整個多工緩衝處理工作—印表機 Nothing。 如果列印管理員正在使用未啟動列印工作,則可能會傳送至印表機,在 AbortDoc 呼叫之前。 在這種情況下,印表機驅動程式會重設印表機 (如果可能) 並關閉列印工作。
範例
CDC::StartDoc。請參閱範例。
需求
Header: afxwin.h