StartRenderPageJob

Ispezione dei documenti, rendering

Descrizione

Avvia un processo in background che esegue il rendering di una pagina PDF senza bloccare il thread del chiamante

Poiché TPDFlib non è thread-safe, il processo crea un'istanza isolata dallo stesso file di origine e viene eseguito in un'attività di sistema, così una pagina di grandi dimensioni non può più occupare il thread host fino al completamento

Il processo passa al renderer un flag di annullamento e un gate di pausa a reimpostazione manuale, controllati tra gli operatori; ciò consente a PauseRenderJob, ResumeRenderJob e CancelRenderJob di interrompere una pagina in corso

Sintassi

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

Parametri

FileName	Il percorso del file PDF sorgente
Password	La password del documento oppure una stringa vuota quando il PDF non è cifrato
OutputFileName	Percorso immagine di destinazione; il formato segue `Options` come `RenderPageToFile`
DPI	La risoluzione di rendering
Page	Il numero di pagina a base 1 da renderizzare
Options	L'opzione del formato immagine passata direttamente a `RenderPageToFile`

Valori restituiti

>0	Un handle del processo in base uno da usare con i metodi di controllo del rendering
0	Impossibile avviare il job

Note

Controllare l'avanzamento con GetRenderJobState e attendere con WaitForRenderJob; entrambe restituiscono codici RENDER_JOB_STATE_*

Usare PauseRenderJob, ResumeRenderJob e CancelRenderJob per interrompere una pagina senza perdere il thread worker

L'istanza che ha avviato il processo ne è proprietaria; liberare l'istanza attende i processi in sospeso, così una pagina incompleta non sopravvive al proprietario