共用方式為


CDC::AbortDoc

結束目前的列印工作並清除應用程式提供裝置時,因為最後一個呼叫將 StartDoc 成員函式的所有項目。

int AbortDoc( );

傳回值

大於或等於 0 的值,如果成功或負值,則會發生錯誤。 下列清單顯示常見錯誤值及其意義:

  • SP_ERROR 一般錯誤。

  • SP_OUTOFDISK 沒有足夠的磁碟空間供多工緩衝處理可用,,而且不再發生空間不會變成可用狀態。

  • SP_OUTOFMEMORY 沒有足夠的記憶體來多工緩衝處理可供使用。

  • SP_USERABORT 使用者透過列印管理員正在結束這個工作。

備註

此成員函式取代 ABORTDOC 印表機逸出。

應該用來AbortDoc 終止如下:

  • 使用 SetAbortProc,不指定停駐點功能的列印作業。

  • 未到達其第一 NEWFRAMENEXTBAND 逸出呼叫的列印作業。

如果應用程式遇到的錯誤或已取消的列印作業,都不可以嘗試終止作業使用類別 CDCEndDocAbortDoc 成員函式。 GDI 在傳回錯誤值之前自動終止作業。

如果應用程式會顯示 對話方塊可讓使用者取消列印作業,必須在終結對話方塊之前呼叫 AbortDoc

如果列印管理員正在使用開始列印工作,呼叫 AbortDoc 清除整個多工緩衝處理工作—印表機 Nothing。 如果列印管理員正在使用未啟動列印工作,則可能會傳送至印表機,在 AbortDoc 呼叫之前。 在這種情況下,印表機驅動程式會重設印表機 (如果可能) 並關閉列印工作。

範例

CDC::StartDoc。請參閱範例。

需求

Header: afxwin.h

請參閱

參考

CDC 類別

階層架構圖表

CDC::StartDoc

CDC::EndDoc

CDC::SetAbortProc