IContinueCallback::FContinuePrinting-Methode (docobj.h)

Artikel
03/01/2024

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

Freigeben über