Partager via

Méthode IContinueCallback ::FContinuePrinting (docobj.h)

  • Article

Indique si une longue opération d’impression doit se poursuivre.

Syntaxe

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

Paramètres

[in] nCntPrinted

Nombre total de pages qui ont été imprimées au moment où l’objet reçoit un appel à FContinuePrinting.

[in] nCurPage

Numéro de page de la page en cours d’impression au moment où l’objet reçoit un appel à FContinuePrinting.

[in] pwszPrintStatus

Pointeur vers le message relatif à la status actuelle du travail d’impression. L’objet en cours d’impression peut ou non afficher ce message à l’utilisateur. Ce paramètre peut être NULL.

Valeur retournée

Cette méthode peut retourner la valeur de retour standard E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour Description
S_OK
 Poursuivez l’opération d’impression.
S_FALSE
 Annulez l’opération d’impression dès que possible.

Remarques

Les implémentations d’IPrint ::P rint appellent cette méthode à intervalles périodiques pendant le processus d’impression. L’implémentation IPrint doit rappeler au moins après l’impression de chaque page, afin que son client puisse, si nécessaire, afficher des commentaires visuels utiles à l’utilisateur. IPrint ::P rint peut rappeler plusieurs fois avec les mêmes valeurs nCntPrinted et nCurPage , ce qui est parfois utile lorsqu’une page en cours d’impression est complexe et qu’il convient de donner à un utilisateur la possibilité d’annuler en milieu de page.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête docobj.h

Voir aussi

IContinueCallback

Iprint