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 עוצרת את הפעולה, סוגרת זרמים פעילים ומסירה פלט לא שלם. מיזוגי רשימת-קבצים פותחים כל מקור לסריקה שלו ומשאירים לכל היותר את קוראי המקור הראשון והנוכחי פעילים בזמן הכתיבה, כך שהשימוש ב-handles נשאר תחום ככל שהרשימה גדלה
ערכי החזרה
| מספר המסמכים שמוזגו בהצלחה. אם המספר קטן מהמתוכנן, השתמשו בפונקציה FileListItem כדי למצוא את הקובץ שגרם לתהליך המיזוג להסתיים מוקדם מדי |