IContinueCallback::FContinuePrinting-Methode (docobj.h)

  • Artikel

Gibt an, ob ein längerer Druckvorgang fortgesetzt werden soll.

Syntax

HRESULT FContinuePrinting(
  [in] LONG    nCntPrinted,
  [in] LONG    nCurPage,
  [in] wchar_t *pwszPrintStatus
);

Parameter

[in] nCntPrinted

Die Gesamtanzahl der Seiten, die gedruckt wurden, wenn das Objekt einen Aufruf von FContinuePrinting empfängt.

[in] nCurPage

Die Seitennummer der Seite, die gedruckt wird, wenn das Objekt einen Aufruf von FContinuePrinting empfängt.

[in] pwszPrintStatus

Ein Zeiger auf die Meldung zum aktuellen status des Druckauftrags. Das gedruckte Objekt kann diese Meldung für den Benutzer anzeigen oder nicht. Dieser Parameter kann NULL sein.

Rückgabewert

Diese Methode kann den Standardrückgabewert E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Fahren Sie mit dem Druckvorgang fort.
S_FALSE
 Brechen Sie den Druckvorgang so schnell wie möglich ab.

Hinweise

Implementierungen von IPrint::P rint rufen diese Methode während des Druckprozesses in regelmäßigen Abständen auf. Die IPrint-Implementierung sollte mindestens nach dem Drucken der einzelnen Seiten zurückrufen, damit der Client dem Benutzer bei Bedarf nützliches visuelles Feedback anzeigen kann. IPrint::P rint kann mehrmals mit denselben Werten von nCntPrinted und nCurPage zurückrufen. Dies ist manchmal nützlich, wenn eine seite gedruckt wird, komplex ist und es geeignet ist, einem Benutzer die Möglichkeit zu geben, die Seitenmitte abzubrechen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile docobj.h

Weitere Informationen

IContinueCallback

Iprint