CDC::AbortDoc

int AbortDoc ( );

Valeur de retour

Une valeur supérieure ou égale à 0 en cas de succès, ou une valeur négative si une erreur s'est produite. La liste suivante indique les valeurs d'erreur communs et leur signification:

• SP_ERROR  ;  Erreur générale.
  
  
• SP_OUTOFDISK  ;  Pas assez d'espace disque n'est actuellement disponible pour la mise en attente, et aucun plus d'espace ne sera disponible.
  
  
• SP_OUTOFMEMORY  ;  Pas assez de mémoire n'est disponible pour la mise en attente.
  
  
• SP_USERABORT  ;  Utilisateur a mis fin à l'emploi par le biais du gestionnaire d'impression.

Remarques

Termine le travail d'impression actuel et efface tout ce que l'application a écrit sur le périphérique depuis le dernier appel à la fonction de membre StartDoc.

Cette fonction membre remplace l'évasion d'imprimante ABORTDOC.

AbortDoc doit être utilisé pour mettre fin à ce qui suit:

• Impression des opérations qui ne spécifient pas une fonction abort suppriment.
  
  
• Impression des opérations qui n'ont pas encore atteint leur premier NEWFRAME ou NEXTBAND échappent à appel.

Si une application rencontre une erreur d'impression ou une opération d'impression annulée, il ne doit pas tenter de mettre fin à l'opération en utilisant le EndDoc ou AbortDoc des fonctions de membre de classe de CDC. GDI met automatiquement fin à l'opération avant de retourner la valeur d'erreur.

Si l'application affiche une boîte de dialogue pour permettre à l'utilisateur d'annuler l'opération d'impression, il doit appeler AbortDoc avant de détruire la boîte de dialogue.

Si le gestionnaire d'impression a été utilisé pour démarrer le travail d'impression, appeler AbortDoc efface le travail ensemble bobine — l'imprimante ne reçoit rien. Si le gestionnaire d'impression n'a pas servi à démarrer le travail d'impression, les données peuvent ont été envoyées à l'imprimante avant que AbortDoc a été appelée. Dans ce cas, le pilote d'imprimante serait ont réinitialiser l'imprimante (lorsque cela est possible) et fermé le travail d'impression.

Aperçu de la CDC |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CDC::StartDoc, CDC::EndDoc, CDC::SetAbortProc