StartRenderPageJob

Inspekcja dokumentu, Renderowanie

Opis

Uruchamia zadanie w tle renderujące stronę pliku PDF bez blokowania wątku kodu wywołującego

Ponieważ TPDFlib nie jest bezpieczny wątkowo, zadanie tworzy izolowaną instancję z tego samego pliku źródłowego i działa jako zadanie systemowe, dzięki czemu duża strona nie zajmuje wątku hosta aż do zakończenia

Zadanie przekazuje do modułu renderującego flagę anulowania i bramkę wstrzymania z ręcznym resetowaniem, sprawdzane między operatorami strumienia zawartości; dzięki temu PauseRenderJob, ResumeRenderJob i CancelRenderJob mogą przerwać pojedynczą stronę w trakcie przetwarzania

Składnia

Delphi

Function TPDFlib.StartRenderPageJob(Const FileName, Password, OutputFileName: WideString; DPI: Double; Page, Options: Integer): Integer;

DLL

int DLStartRenderPageJob(int InstanceID, const wchar_t* FileName, const wchar_t* Password, const wchar_t* OutputFileName, double DPI, int Page, int Options);

ActiveX

Function PDFlib::StartRenderPageJob(FileName As String, Password As String, OutputFileName As String, DPI As Double, Page As Long, Options As Long) As Long

Parametry

FileName	Ścieżka źródłowego pliku PDF
Password	Hasło dokumentu albo pusty ciąg, gdy plik PDF nie jest zaszyfrowany
OutputFileName	Ścieżka docelowego obrazu; format wynika z `Options` tak jak w `RenderPageToFile`
DPI	Rozdzielczość renderowania
Page	Numer renderowanej strony liczony od 1
Options	Opcja formatu obrazu przekazywana bezpośrednio do `RenderPageToFile`

Wartości zwracane

>0	Uchwyt zadania liczony od 1, używany z metodami sterowania zadaniem renderowania
0	Nie udało się uruchomić zadania

Uwagi

Sprawdzaj postęp za pomocą GetRenderJobState i blokuj oczekiwanie za pomocą WaitForRenderJob; obie metody zwracają kody RENDER_JOB_STATE_*

Użyj PauseRenderJob, ResumeRenderJob i CancelRenderJob, aby przerwać działającą stronę bez utraty wątku roboczego

Zadanie należy do instancji, która je uruchomiła; zwalnianie instancji dołącza niezakończone zadania, dlatego częściowo ukończona strona nigdy nie przeżyje swojego właściciela