AddLinkToImportDataA
Chú thích và liên kết hotspot, Trường biểu mẫu và AcroForms
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 AddLinkToImportData 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 hotspot bấm được vào trang đang chọn, kích hoạt hành động import-data của PDF. Hành động import-data đổ dữ liệu vào các trường AcroForm của tài liệu từ một file Forms Data Format (FDF) trên đĩa. Hành động được định nghĩa tại ISO 32000-1 §12.6.4.8, Table 198
Trường hợp điển hình: link “Nạp lại dữ liệu mẫu” hoặc “Về mặc định” trong một form tương tác, nơi file FDF đi kèm PDF và giữ các giá trị trường chuẩn tắc
Dùng hàm SetAnnotBorderColor để đổi màu viền của hotspot
Cú pháp
Delphi
Function DLAddLinkToImportDataA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; Options: Integer): Integer;DLL
int DLAddLinkToImportDataA(int InstanceID, double Left, double Top, double Width, double Height, const char * FileName, int Options);Tham số
| Left | Tọa độ ngang của cạnh trái hình chữ nhật hotspot |
|---|---|
| Top | Tọa độ dọc của cạnh trên hình chữ nhật hotspot |
| Width | Chiều rộng của hình chữ nhật hotspot |
| Height | Chiều cao của hình chữ nhật hotspot |
| FileName | Đường dẫn tới file FDF dùng để đổ dữ liệu vào các trường biểu mẫu. Dấu gạch ngược được đổi thành gạch xuôi theo dạng path chuẩn PDF tại ISO 32000-1 §7.11.2.1. File không cần tồn tại lúc tạo PDF nhưng phải có mặt khi xem thì hành động mới thành công |
| Options | Bitmask điều khiển hiển thị link. Bit 0 (giá trị 1): vẽ viền quanh hình chữ nhật hotspot. Các bit 1–3 chọn chế độ highlight khi click (2 = Invert, 4 = Outline, 8 = Push); khi không bật bit highlight nào, mặc định là Invert. Cùng quy ước với AddLinkToWeb / AddLinkToHideField |
Ghi chú
KHÔNG được phép trong PDF/A vì hành động tham chiếu một resource ngoài. Khi tài liệu đang ở chế độ PDF/A, hàm âm thầm trả về 0 và không có chú thích nào được thêm. Yêu cầu PDF 1.4 trở lên