AddLinkToImportData

Anotasi dan tautan hotspot, Bidang formulir dan AcroForm

Deskripsi

Menambahkan rectangle hotspot yang bisa diklik ke halaman terpilih yang memicu aksi PDF import-data saat diaktifkan. Aksi import-data mengisi field AcroForm dokumen dari file Forms Data Format (FDF) di disk. Aksi ini didefinisikan di ISO 32000-1 §12.6.4.8, Table 198

Pemakaian tipikal: tautan “Reload sample data” atau “Reset to defaults” dalam form interaktif, di mana file FDF dikirim bersama PDF dan memuat nilai field kanonik

Gunakan fungsi SetAnnotBorderColor untuk mengubah warna border hotspot

Sintaks

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);

Parameter

Left	Koordinat horizontal tepi kiri persegi hotspot
Top	Koordinat vertikal tepi atas persegi hotspot
Width	Lebar persegi hotspot
Height	Tinggi persegi hotspot
FileName	Path ke file FDF dari mana bidang formulir akan diisi. Backslash dikonversi menjadi garis miring sesuai bentuk path kanonik PDF pada ISO 32000-1 §7.11.2.1. File tidak perlu ada saat PDF dibuat, tetapi harus tersedia saat dokumen dilihat agar aksi berhasil.
Options	Bitmask yang mengendalikan tampilan tautan. Bit 0 (nilai 1): menggambar tepi di sekeliling persegi hotspot. Bit 1–3 memilih mode sorot klik (2 = Invert, 4 = Outline, 8 = Push); bila tidak ada bit sorot yang disetel, Invert dipakai sebagai default. Konvensi sama seperti AddLinkToWeb / AddLinkToHideField.

Keterangan

Mode PDF/A dan PDF/X-6 menolak aksi ImportData dan mengembalikan 0 tanpa menambahkan anotasi; dibutuhkan PDF 1.4 atau yang lebih baru