MergeFileList
معالجة المستندات
الوصف
يدمج جميع الملفات في قائمة ملفات مسماة ويحفظ المستند المدموج الناتج في الملف المحدد. استخدم الدوال ClearFileList وFileListCount وAddToFileList لبناء قائمة الملفات المسماة. ويجب أن تضم قائمة الملفات ملفين أو أكثر لتنجح عملية الدمج
ستكون المخططات التفصيلية (الإشارات المرجعية) وحقول النموذج والتعليقات التوضيحية من جميع المستندات موجودة في المستند المدموج
يتناوب مسار الدمج العادي ملفات الإخراج المؤقتة بعد أول زوج من ملفات الإدخال، متجنبًا نسخة كاملة إضافية من PDF الوسيط المتنامي عن كل مدخل لاحق. يحافظ ذلك على سلوك عدد الإرجاع القائم مع خفض إدخال/إخراج القرص في قوائم الملفات الأطول
الصيغة
Delphi
Function TPDFlib.MergeFileList(Const ListName, OutputFileName: WideString): Integer;
ActiveX
Function PDFlib::MergeFileList(ListName As String, OutputFileName As String) As Long
DLL
int DLMergeFileList(int InstanceID, const wchar_t * ListName, const wchar_t * OutputFileName);
المعاملات
| ListName | اسم قائمة الملفات المطلوب دمجها معًا المسار واسم الملف المطلوب إنشائه والذي سيحتوي الملفات المدموجة |
|---|---|
| OutputFileName |
الإلغاء والموارد
تُبلغ عملية الدمج عن التقدم أثناء فحص المدخلات وكتابة الكائنات. واستدعاء Abort يوقف العملية ويغلق التدفقات النشطة ويزيل الإخراج غير المكتمل. وتفتح عمليات دمج قوائم الملفات كل مصدر لفحصه وتُبقي على قارئي المصدر الأول والمصدر الحالي نشطين كحد أقصى أثناء الكتابة، فيبقى استخدام المقابض محدودًا مع نمو القائمة
قيم الإرجاع
| عدد المستندات التي دُمجت بنجاح معًا. إذا كان هذا أقل من العدد المقصود فاستخدم الدالة FileListItem للعثور على الملف الذي أنهى عملية الدمج قبل أوانها |