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ố

ListNameTê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