AddLinkToImportData
Chú thích và liên kết điểm nóng, Trường biểu mẫu và AcroForms
Mô tả
Thêm một hình chữ nhật điểm nóng có thể nhấp vào trang đang chọn, khi được kích hoạt sẽ phát sinh hành động import-data của PDF. Hành động import-data điền các trường AcroForm của tài liệu từ một tệp Forms Data Format (FDF) trên đĩa. Hành động này được định nghĩa trong ISO 32000-1 §12.6.4.8, Table 198Cách dùng điển hình: liên kết “Tải lại dữ liệu mẫu” hoặc “Đặt lại về mặc định” trong biểu mẫu tương tác, nơi tệp FDF đi kèm cùng tệp PDF và chứa các giá trị trường chuẩnDùng hàm SetAnnotBorderColor để đổi màu viền của điểm nóng
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 TPDFlib.AddLinkToImportData(Left, Top, Width, Height: Double; Const FileName: WideString; Options: Integer): Integer;
DLL
int DLAddLinkToImportData(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int Options);
Tham số
| Left | Tọa độ ngang của cạnh trái hình chữ nhật điểm nóng |
|---|---|
| Top | Tọa độ dọc của cạnh trên hình chữ nhật điểm nóng |
| Width | Chiều rộng hình chữ nhật điểm nóng |
| Height | Chiều cao hình chữ nhật điểm nóng |
| FileName | Đường dẫn tới tệp FDF dùng để điền các trường biểu mẫu. Dấu gạch ngược được chuyển thành dấu gạch xuôi theo dạng đường dẫn PDF chuẩn trong ISO 32000-1 §7.11.2.1. Tệp không cần tồn tại tại thời điểm tạo PDF nhưng phải có mặt tại thời điểm xem để hành động thành công. |
| Options | Mặt nạ bit điều khiển hình thức liên kết. Bit 0 (giá trị 1): vẽ viền quanh hình chữ nhật điểm nóng. Bit 1–3 chọn chế độ tô sáng khi nhấp (2 = Invert, 4 = Outline, 8 = Push); khi không đặt bit tô sáng nào, Invert được dùng làm mặc định. Cùng quy ước với AddLinkToWeb / AddLinkToHideField. |
Ghi chú
Chế độ PDF/A và PDF/X-6 từ chối các hành động ImportData và trả về 0 mà không thêm chú thích; yêu cầu PDF 1.4 trở lên