MergeFileList
Thao tác tài liệu
Mô tả
Gộp tất cả file trong một named file list và lưu tài liệu kết quả ra file chỉ định. Dùng các hàm ClearFileList, FileListCount và AddToFileList để dựng named file list. Danh sách phải có từ hai file trở lên thì việc gộp mới thành công
Đề mục (bookmark), trường biểu mẫu và chú thích từ tất cả các tài liệu sẽ có mặt trong tài liệu sau khi gộp
Đường gộp thông thường xoay vòng các file đầu ra tạm sau cặp file đầu vào đầu tiên, tránh phải copy thêm một bản đầy đủ của PDF trung gian đang phình to cho mỗi đầu vào tiếp theo. Hành vi đếm kết quả trả về giữ nguyên trong khi giảm disk I/O với danh sách file dài
Cú pháp
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);
Tham số
| ListName | Tên danh sách file cần gộp lại với nhau Đường dẫn và tên file cần tạo để chứa các file sau khi gộp |
|---|---|
| OutputFileName |
Hủy và tài nguyên
Quá trình gộp báo tiến trình trong lúc quét đầu vào và ghi object. Gọi Abort sẽ dừng thao tác, đóng các stream đang hoạt động và xóa đầu ra chưa hoàn chỉnh. Gộp theo file list mở từng nguồn cho lượt quét của nó và giữ tối đa reader của nguồn đầu và nguồn hiện tại trong lúc ghi, nên mức dùng handle luôn có giới hạn kể cả khi danh sách dài ra
Giá trị trả về
| Số tài liệu đã gộp thành công với nhau. Nếu nhỏ hơn số dự kiến, dùng hàm FileListItem để tìm file khiến quá trình gộp kết thúc sớm |