StartRenderPageJob

Dokumentinspektion, Rendering

Beskrivning

Startar ett bakgrundsjobb som renderar en sida i en PDF-fil utan att blockera anroparens tråd

Eftersom TPDFlib inte är trådsäkert skapar jobbet en isolerad instans från samma källfil och körs som en systemuppgift, så att en stor sida inte längre kan äga värdtråden förrän den är klar

Eftersom TPDFlib inte är trådsäker skapar jobbet en isolerad instans från samma källfil och körs på en systemuppgift, så en stor sida inte längre kan äga värdtråden tills den är klarJobbet trådar en avbrytsflagga och en manual-reset-pausgrind in i renderaren, som pollar dem mellan content stream-operatorer; det är det som låter PauseRenderJob, ResumeRenderJob och CancelRenderJob avbryta en enda pågående sida

Syntax

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

Parametrar

Returvärden

Anmärkningar

Polla förlopp med GetRenderJobState och blockera med WaitForRenderJob; båda returnerar RENDER_JOB_STATE_*-kodernaUse

PauseRenderJob, ResumeRenderJob och CancelRenderJob för att avbryta en pågående sida utan att förlora arbetstråden

Instansen som startade jobbet äger det; frigörs instansen väntar man in pågående jobb, så en halvfärdig sida överlever aldrig sin ägare