MergeFileListFast
Thao tác tài liệu
Mô tả
Tương tự hàm MergeFileList nhưng dùng thuật toán nâng cao để tăng tốc
Trong quá trình gộp sẽ tạo một file list mới chứa kết quả merge của từng mục trong file list chỉ định. File list mới có tên trùng file list gốc kèm hậu tố Result. Ví dụ, file list gốc tên "MyFiles" thì file list mới sẽ là "MyFilesResult". File list mới này không chứa tên file mà chứa mô tả bằng chữ về trạng thái xử lý của từng file trong quá trình gộp
Danh sách phải có từ hai file trở lên thì việc gộp mới thành công
Trường biểu mẫu, chú thích và đề mục (bookmark) từ tất cả các tài liệu sẽ có mặt trong tài liệu sau khi gộp
Cú pháp
Delphi
Function TPDFlib.MergeFileListFast(Const ListName, OutputFileName: WideString): Integer;
ActiveX
Function PDFlib::MergeFileListFast(ListName As String, OutputFileName As String) As Long
DLL
int DLMergeFileListFast(int InstanceID, const wchar_t * ListName, const wchar_t * OutputFileName);
Tham số
| ListName | Tên file list cần dùng. Toàn bộ file trong danh sách sẽ được gộp lại với nhau |
|---|---|
| OutputFileName | Đường dẫn và tên file đầu ra cần tạo. File này sẽ chứa toàn bộ các file trong file list |
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ề
| 0 | Không hoàn tất được quá trình gộp. Dùng hàm GetLastError để xác định nguyên nhân lỗi |
|---|---|
| Non-zero | Số file đã gộp thành công |