MergeFileList
دستکاری سند
توضیحات
همهٔ فایلهای فهرست فایل نامگذاریشده را ادغام کرده و سند حاصل را در فایل مشخصشده ذخیره میکند؛ برای ساختن فهرست از توابع ClearFileList، FileListCount و AddToFileList استفاده کنید. برای موفقیت ادغام، حداقل دو فایل باید در فهرست باشد
نشانکها، فیلدهای فرم و حاشیهنویسیهای همهٔ اسناد در سند ادغامشده حاضر خواهند بود
مسیر معمول merge پس از جفت اول فایلهای ورودی، بین فایلهای خروجی موقت بهصورت تناوبی جابهجا میشود و برای هر ورودی بعدی از یک کپی کامل اضافی از PDF میانیِ در حال رشد جلوگیری میکند. این کار رفتار فعلیِ شمارش مقدار بازگشتی را حفظ میکند و در فهرستهای طولانیتر، I/O دیسک را کاهش میدهد
نحو
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 عملیات را متوقف، استریمهای فعال را میبندد و خروجی ناقص را حذف میکند. ادغامهای فهرست فایل، هر مبدأ را برای اسکن باز میکنند و هنگام نوشتن حداکثر readerهای مبدأ اول و جاری را فعال نگه میدارند تا مصرف هندل با بزرگ شدن فهرست محدود بماند
مقادیر بازگشتی
| تعداد سندهایی را که با موفقیت با هم merge شدهاند. اگر این مقدار از تعداد موردنظر کمتر است، از تابع FileListItem برای یافتن فایلی استفاده کنید که باعث شد فرایند merge زودتر متوقف شود |