RequestPrinterStatus
Rendu et impression
Description
Utilisez cette fonction pour activer un autre système d’impression capable de renvoyer l’état de l’imprimante. De nombreux codes d’état proviennent du pilote, sans garantie que leurs valeurs contiennent des informations significatives pour toutes les imprimantes
La première étape consiste à appeler cette fonction avec StatusCommand=101 pour activer la surveillance de l’imprimante. La tâche peut facultativement démarrer en pause par un nouvel appel avec StatusCommand=103, ce qui peut être nécessaire pour les petites tâches qui se termineraient avant la lecture de l’état
Le travail d'impression peut alors être lancé normalement avec l'une des fonctions d'impression suivantes : PrintDocument, PrintDocumentToFile ou
PrintDocumentToPrinterObject.
Une fois la tâche d’impression lancée, cette fonction peut être rappelée régulièrement afin d’obtenir son état au fil du temps. Si la tâche a démarré en pause, l’impression réelle ne commence qu’après un appel avec StatusCommand=402
Syntaxe
Delphi
Function TPDFlib.RequestPrinterStatus(StatusCommand: Integer): Integer;
ActiveX
Function PDFlib::RequestPrinterStatus(StatusCommand As Long) As Long
DLL
int DLRequestPrinterStatus(int InstanceID, int StatusCommand);
Paramètres
| StatusCommand | 100 = Désactiver la surveillance de l’état de l’imprimante. 101 = Activer la surveillance de l’état de l’imprimante. 102 = Renvoie 1 si cette surveillance est active. 103 = Démarrer le travail d’impression en pause. 104 = Démarrer immédiatement l’impression. 105 = Renvoie 1 si le travail démarrera en pause. 200 = Renvoie 1 si des données de travail existent. 201 = Renvoie le JobID du spouleur Windows. 202 = Renvoie la priorité du travail, de 1 à 99. 203 = Renvoie la position du travail's dans la file d’impression. 204 = Renvoie le nombre total de pages. 205 = Renvoie le nombre de pages imprimées, généralement zéro si le type de données est "RAW". 206 = Renvoie le nombre de millisecondes écoulées depuis le démarrage du travail. 207 = Renvoie le type de données : 1 s’il contient "RAW", 2 s’il contient "EMF", 3 s’il contient "TEXT", 4 s’il contient "XPS" 300 = Renvoie l’état encodé du travail. 301 = Renvoie 1 si le travail est en pause. 302 = Renvoie 1 en cas d’erreur. 303 = Renvoie 1 si le travail est en cours de suppression. 304 = Renvoie 1 si le travail est mis en file d’attente. 305 = Renvoie 1 si le travail est en cours d’impression. 306 = Renvoie 1 si l’imprimante est hors connexion. 307 = Renvoie 1 si elle manque de papier. 308 = Renvoie 1 si le travail a été imprimé. 309 = Renvoie 1 s’il a été supprimé. 310 = Renvoie 1 si le pilote ne peut pas imprimer le travail. 311 = Renvoie 1 si l’imprimante présente une erreur nécessitant une intervention. 312 = Renvoie 1 si le travail a redémarré. 313 = Sous Windows XP et versions ultérieures, renvoie 1 si le travail a été envoyé à l’imprimante, même s’il n’est pas encore imprimé. 314 = Sous Windows Vista et versions ultérieures, renvoie 1 si le travail est conservé dans la file et ne peut pas être supprimé. 401 = Mettre le travail en pause. 402 = Reprendre un travail en pause. 403 = Supprimer le travail |
|---|