AddLinkToSubmitForm
Anotasi dan tautan hotspot, Bidang formulir dan AcroForms
Deskripsi
Menambahkan persegi panjang hotspot yang dapat diklik ke halaman terpilih yang memicu tindakan submit-form PDF saat diaktifkan. Tindakan submit-form mengirimkan nilai bidang AcroForm ke URL atau titik akhir pemrosesan formulir tanpa memerlukan JavaScript
Gunakan FieldNames untuk membatasi bidang yang dikirim. Biarkan FieldNames kosong untuk membiarkan penampil mengirimkan semua bidang yang berlaku
Gunakan fungsi SetAnnotBorderColor untuk mengubah warna batas hotspot
Sintaks
Delphi
Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);Parameter
| Left | Koordinat horizontal dari tepi kiri persegi panjang hotspot |
|---|---|
| Top | Koordinat vertikal dari tepi atas persegi panjang hotspot |
| Width | Lebar dari persegi panjang hotspot |
| Height | Tinggi dari persegi panjang hotspot |
| URL | URL target pengiriman yang disimpan dalam spesifikasi file tindakan |
| FieldNames | Daftar opsional nama bidang AcroForm berkualifikasi penuh yang dipisahkan dengan koma, titik koma, atau jeda baris. Spasi putih di awal dan akhir pada setiap nama dipangkas |
| Flags | Bendera tindakan submit-form PDF ditulis ke entri /Flags tindakan. Lewati 0 untuk pengiriman gaya FDF default. Bit standar umum termasuk 4 untuk format HTML, 32 untuk XFDF, dan 256 untuk mengirimkan seluruh dokumen PDF |
| Options | Bitmask yang mengontrol penampilan tautan. Bit 0 (nilai 1): menggambar batas di sekitar persegi panjang hotspot. Bit 1-3 memilih mode sorotan klik (2 = Invert, 4 = Outline, 8 = Push); ketika tidak ada bit sorotan yang diatur, Invert digunakan sebagai default |
Nilai kembalian
| 0 | Tindakan tidak ditambahkan karena dokumen berada dalam mode PDF/A, persegi panjang tidak valid, atau URL kosong |
|---|---|
| 1 | Anotasi tautan dan tindakan submit-form ditambahkan |
Catatan
Mode PDF/A memblokir tindakan ini karena dapat merujuk ke target pengiriman eksternal. Fungsi ini memerlukan PDF 1.2 atau yang lebih baru