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 زودتر متوقف شود