AddLinkToSubmitForm

Chú thích và liên kết hotspot, Trường biểu mẫu và AcroForms

Mô tả

Thêm một hình chữ nhật hotspot có thể nhấp vào trang đã chọn để kích hoạt hành động gửi biểu mẫu PDF khi được kích hoạt; Hành động gửi biểu mẫu sẽ gửi giá trị các trường AcroForm đến một URL hoặc điểm cuối xử lý biểu mẫu mà không cần JavaScript

Dùng FieldNames để giới hạn các trường được gửi. Để trống FieldNames để trình xem gửi tất cả các trường áp dụng được

Dùng hàm SetAnnotBorderColor để thay đổi màu viền của hotspot

Cú pháp

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

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
URL	URL đích gửi được lưu trong đặc tả tệp của hành động
FieldNames	Danh sách tùy chọn các tên trường AcroForm đầy đủ được phân tách bằng dấu phẩy, dấu chấm phẩy hoặc ngắt dòng. Khoảng trắng ở đầu và cuối mỗi tên sẽ được loại bỏ
Flags	Cờ hành động gửi biểu mẫu PDF được ghi vào mục `/Flags` của hành động. Truyền 0 để dùng phương thức gửi kiểu FDF mặc định. Các bit chuẩn phổ biến gồm 4 cho định dạng HTML, 32 cho XFDF và 256 để gửi toàn bộ tài liệu PDF
Options	Bitmask kiểm soát giao diện liên kết. Bit 0 (giá trị 1): vẽ viền quanh hình chữ nhật hotspot. Bit 1–3 chọn chế độ tô sáng khi nhấp (2 = Invert, 4 = Outline, 8 = Push); khi không có bit tô sáng nào được đặt, Invert được dùng làm mặc định

Giá trị trả về

0	Hành động không được thêm vì tài liệu đang ở chế độ PDF/A, hình chữ nhật không hợp lệ hoặc `URL` rỗng
1	Chú thích liên kết và hành động gửi biểu mẫu đã được thêm

Lưu ý

Chế độ PDF/A chặn hành động này vì nó có thể tham chiếu đến đích gửi bên ngoài. Hàm yêu cầu PDF 1.2 trở lên