RequestPrinterStatus

Renderowanie i drukowanie

Opis

Ta funkcja aktywuje alternatywny system drukowania umożliwiający zwracanie stanu drukarki. Wiele zwracanych kodów stanu pochodzi ze sterownika drukarki, dlatego nie ma gwarancji, że wartości będą zawierały znaczące informacje dla każdej drukarki

Pierwszym krokiem jest wywołanie tej funkcji z StatusCommand=101 w celu włączenia monitorowania stanu drukarki. Opcjonalnie zadanie drukowania można uruchomić w stanie wstrzymania, ponownie wywołując funkcję z StatusCommand=103. Może to być konieczne dla małych zadań, które w przeciwnym razie zakończyłyby się przed odczytaniem stanu

Następnie zadanie drukowania można uruchomić w zwykły sposób za pomocą jednej z funkcji drukowania: PrintDocument, PrintDocumentToFile lub

PrintDocumentToPrinterObject.

Po rozpoczęciu zadania drukowania funkcję można wielokrotnie wywoływać, aby z czasem uzyskiwać jego stan z drukarki. Jeśli zadanie uruchomiono w stanie wstrzymania, rzeczywiste drukowanie rozpocznie się dopiero po wywołaniu funkcji z StatusCommand=402

Składnia

Delphi

Function TPDFlib.RequestPrinterStatus(StatusCommand: Integer): Integer;

ActiveX

Function PDFlib::RequestPrinterStatus(StatusCommand As Long) As Long

DLL

int DLRequestPrinterStatus(int InstanceID, int StatusCommand);

Parametry

StatusCommand100 = Wyłącza monitorowanie stanu drukarki. 101 = Włącza monitorowanie stanu drukarki. 102 = Zwraca 1, jeśli monitorowanie stanu drukarki jest aktywne. 103 = Uruchamia zadanie drukowania w stanie wstrzymania. 104 = Natychmiast rozpoczyna drukowanie. 105 = Zwraca 1, jeśli zadanie drukowania zostanie uruchomione w stanie wstrzymania. 200 = Zwraca 1, jeśli istnieją dane zadania drukowania. 201 = Zwraca JobID bufora wydruku Windows. 202 = Zwraca priorytet zadania od 1 do 99. 203 = Zwraca wartość job's position, czyli pozycję zadania w kolejce drukowania. 204 = Zwraca całkowitą liczbę stron. 205 = Zwraca liczbę wydrukowanych stron. Zwykle jest to zero, jeśli typem danych jest "RAW". 206 = Zwraca liczbę milisekund od rozpoczęcia zadania drukowania. 207 = Zwraca typ danych zadania drukowania Zwraca 1, jeśli typ danych zawiera "RAW" Zwraca 2, jeśli typ danych zawiera "EMF" Zwraca 3, jeśli typ danych zawiera "TEXT" Zwraca 4, jeśli typ danych zawiera "XPS" 300 = Zwraca zakodowany stan zadania. 301 = Zwraca 1, jeśli zadanie jest wstrzymane. 302 = Zwraca 1, jeśli wystąpił błąd. 303 = Zwraca 1, jeśli zadanie jest usuwane. 304 = Zwraca 1, jeśli zadanie jest buforowane. 305 = Zwraca 1, jeśli zadanie jest drukowane. 306 = Zwraca 1, jeśli drukarka jest offline. 307 = Zwraca 1, jeśli w drukarce zabrakło papieru. 308 = Zwraca 1, jeśli zadanie zostało wydrukowane. 309 = Zwraca 1, jeśli zadanie zostało usunięte. 310 = Zwraca 1, jeśli sterownik nie może wydrukować zadania. 311 = Zwraca 1, jeśli drukarka ma błąd wymagający działania użytkownika. 312 = Zwraca 1, jeśli zadanie zostało uruchomione ponownie. 313 = W systemie Windows XP i nowszych zwraca 1, jeśli zadanie wysłano do drukarki (zadanie może jeszcze nie być wydrukowane). 314 = W systemie Windows Vista i nowszych zwraca 1, jeśli zadanie zostało zachowane w kolejce drukowania i nie można go usunąć. 401 = Wstrzymuje zadanie drukowania. 402 = Wznawia wstrzymane zadanie drukowania. 403 = Usuwa zadanie drukowania