AddLinkToEmbeddedFileA
Document properties, Annotations and hotspot links
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 AddLinkToEmbeddedFile và các tham số chuỗi được diễn giải theo code page hiện tại của SetAnsiMode
Thêm hình chữ nhật chú thích FileAttachment vào trang đang chọn và nối nó với một file nhúng đã có sẵn trong tài liệu
Gọi AddEmbeddedFile trước để copy byte file vào PDF và lấy EmbeddedFileID. AddLinkToEmbeddedFile tạo chú thích trang, ghi tiêu đề attachment cùng nội dung popup, rồi trỏ chú thích vào file specification nhúng đó
Hành vi phiên bản PDF: chú thích FileAttachment và embedded file stream đòi PDF 1.3. Appearance chú thích do hàm này sinh ra có thể chứa độ mờ chú thích qua /CA cùng các resource transparency, đòi PDF 1.4. Nếu phiên bản tài liệu hiện tại thấp hơn và phiên bản lưu chưa bị khóa, AddLinkToEmbeddedFile tự nâng tài liệu lên PDF 1.4 và ghi /CA annotation opacity vào AutoBumpedFeatures. Nếu caller khóa một phiên bản lưu thấp hơn, cổng tương thích từ chối việc lưu với LastErrorCode 602
Cú pháp
Delphi
Function DLAddLinkToEmbeddedFileA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Title, Contents: PAnsiChar; IconType, Transpareny: Integer): Integer;
DLL
int DLAddLinkToEmbeddedFileA(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const char * Title, const char * Contents, int IconType, int Transpareny);
Tham số
| Left | Tọa độ ngang của cạnh trái hình chữ nhật chú thích |
|---|---|
| Top | Tọa độ dọc của cạnh trên hình chữ nhật chú thích |
| Width | Chiều rộng hình chữ nhật chú thích |
| Height | Chiều cao hình chữ nhật chú thích |
| EmbeddedFileID | Giá trị do AddEmbeddedFile trả về |
| Title | Tiêu đề attachment hiển thị trong PDF viewer |
| Contents | Chữ hiển thị trong popup của chú thích |
| IconType | Icon của chú thích: 0 = PushPin, 1 = ảnh đĩa, 2 = không icon, 3 = đồ thị, 4 = kẹp giấy, 5 = tag, 6 = hình chữ nhật trắng đặc |
| Transparency | Tỷ lệ trong suốt từ 0 đến 100. 0 là đặc hoàn toàn; 100 làm icon biến mất hẳn |
Giá trị trả về
| 0 | EmbeddedFileID không hợp lệ, không có trang nào đang chọn, hoặc không có tài liệu nào hoạt động |
|---|---|
| 1 | Chú thích FileAttachment đã được tạo thành công |
Xem thêm
AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount