Contents Index Topic Contents | ||
Previous Topic: IContinueCallback::FContinue Next Topic: IEnumOleDocumentViews |
IContinueCallback::FContinuePrinting
HRESULT FContinuePrinting( LONG cPagesPrinted, LONG nCurrentPage, LPOLESTR pszPrintStatus );Answers whether a given lengthy printing operation should continue.
- Returns one of the following values:
S_OK Continue the printing operation. E_FAIL The printing operation failed. S_FALSE Cancel the print job as soon as possible.
- cPagesPrinted
- Total number of pages that have been printed at the time the object receives a call to this method.
- nCurrentPage
- Page number of the page being printed at the time the object receives a call to this method.
- pszPrintStatus
- Address of a message about the current status of the print job. The object being printed may or may not display this message to the user. Can be NULL.
Implementations of IPrint::Print call this method at periodic intervals during the printing process. The IPrint implementation should call back at least after printing each page, so that its client can, if necessary, display useful visual feedback to the user. IPrint::Print can call back multiple times with the same cPagesPrinted and nCurrentPage values, which is useful when a page being printed is complex and it is appropriate to give a user an opportunity to cancel mid-page.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.