StartRenderPageJob

فحص المستندات، العرض

الوصف

يبدأ مهمة خلفية ترسم صفحة من ملف PDF دون حجب خيط المستدعي

بما أن TPDFlib ليست آمنة خيطيًا، تنشئ المهمة مثيلًا معزولًا من ملف المصدر نفسه وتجري على مهمة نظام، فلم تعد الصفحة الكبيرة تستطيع احتكار خيط المضيف حتى تنتهي

لأن TPDFlib ليست آمنة للخيوط تنشئ المهمة مثيلًا معزولًا من ملف المصدر نفسه وتعمل على مهمة نظام، فلن تملك صفحة كبيرة خيط المضيف بعد الآن حتى تنتهييدس خيوط المهمة علم إلغاء وبوابة إيقاف إعادة ضبط يدوي في العارض، يستطلعهما بين عوامل تدفق المحتوى؛ وهذا ما يتيح لـ PauseRenderJob وResumeRenderJob وCancelRenderJob مقاطعة صفحة واحدة قيد التنفيذ

الصيغة

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

المعاملات

FileNameThe source PDF file path
Passwordكلمة مرور المستند، أو سلسلة فارغة عندما لا يكون PDF مشفرًا
OutputFileNameمسار صورة الوجهة؛ وتتبع الصيغة Options كما في RenderPageToFile
DPIThe render resolution
Pageرقم الصفحة المطلوب رسمها ويبدأ العد من 1
Optionsخيار صيغة الصورة الممرر مباشرةً إلى RenderPageToFile

قيم الإرجاع

>0فهرس عقدة يبدأ من 1، أو 0 لاستخدام أول عقدة
0تعذّر بدء المهمة

ملاحظات

استطلع التقدم بـ GetRenderJobState واحجب التنفيذ بـ WaitForRenderJob؛ وتُرجع كلتاهما رموز RENDER_JOB_STATE_*وتُستخدم

يوفر LastOCRError السبب بالتفصيل

المثيل الذي بدأ المهمة يملكها؛ وتحرير المثيل ينتظر المهام المعلقة، فلن تعيش صفحة نصف منجزة أطول من مالكها