AddLinkToSubmitForm

คำอธิบายประกอบและลิงก์ฮอตสปอต, ฟิลด์ฟอร์มและ AcroForms

คำอธิบาย

เพิ่มพื้นที่สี่เหลี่ยมฮอตสปอตที่คลิกได้ลงในหน้าที่เลือก ซึ่งจะเรียกใช้การดำเนินการส่งฟอร์ม PDF เมื่อเปิดใช้งาน การดำเนินการส่งฟอร์มจะส่งค่าฟิลด์ AcroForm ไปยัง URL หรือตำแหน่งข้อมูลปลายทางสำหรับประมวลผลฟอร์มโดยไม่ต้องใช้ JavaScript

ใช้ FieldNames เพื่อจำกัดฟิลด์ที่ส่ง ปล่อย FieldNames ให้ว่างเปล่าเพื่อให้โปรแกรมดูส่งฟิลด์ทั้งหมดที่เกี่ยวข้อง

ใช้ฟังก์ชัน SetAnnotBorderColor เพื่อเปลี่ยนสีของเส้นขอบฮอตสปอต

ไวยากรณ์

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

พารามิเตอร์

Leftพิกัดแนวนอนของขอบซ้ายของสี่เหลี่ยมฮอตสปอต
Topพิกัดแนวตั้งของขอบบนของสี่เหลี่ยมฮอตสปอต
Widthความกว้างของสี่เหลี่ยมฮอตสปอต
Heightความสูงของสี่เหลี่ยมฮอตสปอต
URLURL เป้าหมายการส่งที่เก็บไว้ในข้อกำหนดไฟล์การดำเนินการ
FieldNamesรายการทางเลือกของชื่อฟิลด์ AcroForm ที่ระบุแบบเต็ม คั่นด้วยเครื่องหมายจุลภาค อัฒภาค หรือการขึ้นบรรทัดใหม่ ช่องว่างนำหน้าและต่อท้ายรอบชื่อแต่ละชื่อจะถูกตัดออก
Flagsแฟล็กการดำเนินการส่งฟอร์ม PDF ที่เขียนลงในรายการ /Flags ของการดำเนินการ ส่งค่า 0 สำหรับการส่งสไตล์ FDF เริ่มต้น บิตมาตรฐานทั่วไปรวมถึง 4 สำหรับรูปแบบ HTML, 32 สำหรับ XFDF และ 256 สำหรับการส่งเอกสาร PDF ทั้งหมด
Optionsบิตมาสก์ควบคุมลักษณะที่ปรากฏของลิงก์ บิต 0 (ค่า 1): วาดเส้นขอบรอบสี่เหลี่ยมฮอตสปอต บิต 1-3 เลือกโหมดเน้นการคลิก (2 = Invert, 4 = Outline, 8 = Push); เมื่อไม่ได้ตั้งค่าบิตเน้นใดๆ Invert จะถูกใช้เป็นค่าเริ่มต้น

ค่าที่ส่งคืน

0ไม่ได้เพิ่มการดำเนินการเนื่องจากเอกสารอยู่ในโหมด PDF/A สี่เหลี่ยมไม่ถูกต้อง หรือ URL ว่างเปล่า
1เพิ่มคำอธิบายประกอบลิงก์และการดำเนินการส่งฟอร์มแล้ว

หมายเหตุ

โหมด PDF/A บล็อกการดำเนินการนี้เนื่องจากสามารถอ้างอิงเป้าหมายการส่งภายนอกได้ ฟังก์ชันนี้ต้องการ PDF 1.2 หรือใหม่กว่า