THotPDF.AddLoadedCheckBox Method
เพิ่มช่องทำเครื่องหมายลงบนหน้าหนึ่งของเอกสารที่โหลดไว้ และ register ลงใน AcroForm ฟิลด์จะได้ appearance state แบบ on กับ off โดย appearance state จะเดินตาม AChecked
การประกาศ
function AddLoadedCheckBox(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AExportValue: AnsiString; AChecked: boolean): Integer;ยูนิต
HPDFDoc
พารามิเตอร์
| ชื่อ | การใช้งาน |
|---|---|
PageIndex | ดัชนีแบบเริ่มจาก 0 ของหน้าที่โหลดไว้ซึ่งรับ widget นี้ |
X1 | ขอบซ้ายของสี่เหลี่ยม widget ในหน่วยพิกัด user space ของ PDF (หน่วย point จุด origin อยู่มุมล่างซ้ายของหน้า) |
Y1 | ขอบล่างของสี่เหลี่ยม widget ใน user space ของ PDF |
X2 | ขอบขวาของสี่เหลี่ยม widget ใน user space ของ PDF |
Y2 | ขอบบนของสี่เหลี่ยม widget ใน user space ของ PDF |
AFieldName | ชื่อของฟิลด์ใหม่ ต้องไม่ซ้ำกับฟิลด์ที่มีอยู่ในฟอร์มที่โหลดไว้ |
AExportValue | ชื่อของสถานะ on และค่าที่ export เมื่อถูกติ้ก ถ้าว่างใช้ Yes |
AChecked | ใส่ true เพื่อสร้างช่องในสถานะติ้กแล้ว |
ค่าที่ส่งกลับ
ดัชนีของฟิลด์ใหม่ ใช้กับ method จัดการ form field ของเอกสารที่โหลดไว้ตัวอื่น หรือ -1 เมื่อ PageIndex อยู่นอกช่วง
การใช้งาน
- ใช้ API นี้ใน workflow ของ page geometry ก่อนที่หน้า resource ฟิลด์ หรือ object catalog ที่ได้รับผลจะถูก finalize
- เก็บชื่ออ็อบเจกต์ ชื่อฟิลด์ ชื่อรีซอร์ส และ handle ที่ได้รับกลับมาให้คงที่ จนกว่าเอกสารจะเสร็จสมบูรณ์
- การอ้างอิงอ็อบเจกต์ในเอกสารที่โหลดแล้วอาจเป็นแบบ indirect ควร resolve array, dictionary หรือ stream ให้เสร็จก่อนตรวจค่าภายใน