StartRenderPageJob

Belge inceleme, İşleme

Açıklama

Çağıranın iş parçacığını engellemeden bir PDF dosyasının sayfasını işleyen bir arka plan işi başlatır

TPDFlib iş parçacığı açısından güvenli olmadığından iş, aynı kaynak dosyadan yalıtılmış bir örnek oluşturup sistem görevinde çalışır; böylece büyük bir sayfa tamamlanana kadar ana bilgisayar iş parçacığını artık elinde tutamaz

İş, işleyiciye bir iptal bayrağı ve elle sıfırlanan duraklatma geçidi aktarır; işleyici bunları içerik akışı işleçleri arasında yoklar. Bu sayede PauseRenderJob, ResumeRenderJob ve CancelRenderJob yürütülmekte olan tek bir sayfayı kesintiye uğratabilir

Sözdizimi

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

Parametreler

FileName	Kaynak PDF dosyasının yolu
Password	Belge parolası veya PDF şifrelenmemişse boş bir dize
OutputFileName	Hedef görüntü yolu; biçim, `Options` değerini `RenderPageToFile` işlevindeki gibi izler
DPI	İşleme çözünürlüğü
Page	İşlenecek 1 tabanlı sayfa numarası
Options	Doğrudan `RenderPageToFile` işlevine geçirilen görüntü biçimi seçeneği

Dönüş değerleri

>0	İşleme işi denetim yöntemleriyle kullanılacak bir tabanlı iş tanıtıcısı
0	İş başlatılamadı

Açıklamalar

İlerlemeyi GetRenderJobState ile yoklayın ve WaitForRenderJob ile bekleyin; ikisi de RENDER_JOB_STATE_* kodlarını döndürür

Çalışan iş parçacığını kaybetmeden çalışan bir sayfayı kesintiye uğratmak için PauseRenderJob, ResumeRenderJob ve CancelRenderJob kullanın

İşi başlatan örnek işin sahibidir; örneğin serbest bırakılması bekleyen işleri birleştirir, böylece yarım kalmış bir sayfa hiçbir zaman sahibinden daha uzun yaşamaz