StoreCustomDataFromFileA
Thuộc tính tài liệu
Mô tả
Hậu tố A là entry point DLL ANSI (char); mặt ActiveX/COM chỉ phơi dạng Unicode. Hành vi giống hệt StoreCustomDataFromFile và các tham số chuỗi được diễn giải theo code page hiện tại của SetAnsiMode
Lưu dữ liệu tùy chỉnh từ một file vào PDF dưới một tên key. Về sau lấy lại được bằng RetrieveCustomDataToString hoặc RetrieveCustomDataToFile. Có thể chọn kiểu lưu (string, stream hoặc stream nén) và vị trí (Document Information Dictionary hoặc Document Catalog). Nếu location là Document Catalog thì kiểu lưu nào cũng dùng được, nhưng key phải có prefix đặc biệt do Adobe cấp. Nếu location là Document Information Dictionary thì key nào trừ các key chuẩn cũng dùng được, nhưng chỉ lưu được dạng string
Cú pháp
Delphi
Function DLStoreCustomDataFromFileA(InstanceID: Integer; Key, FileName: PAnsiChar; Location, Options: Integer): Integer;DLL
int DLStoreCustomDataFromFileA(int InstanceID, const char * Key, const char * FileName, int Location, int Options);Tham số
| Key | Key dùng để lưu dữ liệu. Nếu location là Document Information Dictionary thì key không được là "Author", "Title", "Subject", "Keywords", "Creator" hoặc "Producer". Key khác đều dùng được, nhưng nên chọn cẩn thận để người dùng hiểu được ý nghĩa. Nếu location là Document Catalog thì key phải có prefix đặc biệt do Adobe cấp để tránh xung đột với phần mềm khác |
|---|---|
| FileName | Đường dẫn và tên file chứa dữ liệu cần lưu vào PDF dưới key chỉ định |
| Location | 1 = Lưu dữ liệu trong Document Information Dictionary 2 = Lưu dữ liệu trong Document Catalog |
| Options | 0 = Lưu dữ liệu dạng chuỗi (tùy chọn duy nhất khi location là Document Information Dictionary) 1 = Lưu dữ liệu trong stream 2 = Lưu dữ liệu trong stream nén |
Giá trị trả về
| 0 | Không mở được file chứa dữ liệu, hoặc tham số Key không hợp lệ |
|---|---|
| 1 | Đã lưu dữ liệu thành công |