THotPDF.AddLoadedComboBox Method
เพิ่ม combo box (choice field แบบ drop-down ที่ตั้ง flag Combo) ลงบนหน้าหนึ่งของเอกสารที่โหลดไว้ และ register ลงใน AcroForm appearance stream จะแสดงค่าที่เลือกอยู่
การประกาศ
function AddLoadedComboBox(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; const AOptions: array of AnsiString): 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 | ชื่อของฟิลด์ใหม่ ต้องไม่ซ้ำกับฟิลด์ที่มีอยู่ในฟอร์มที่โหลดไว้ |
AValue | option ที่เลือกไว้ ถ้าว่างคือไม่เลือก |
AOptions | option ที่แสดงในรายการ drop-down |
ค่าที่ส่งกลับ
ดัชนีของฟิลด์ใหม่ ใช้กับ method จัดการ form field ของเอกสารที่โหลดไว้ตัวอื่น หรือ -1 เมื่อ PageIndex อยู่นอกช่วง
การใช้งาน
- ใช้ API นี้ใน workflow ของ page geometry ก่อนที่หน้า resource ฟิลด์ หรือ object catalog ที่ได้รับผลจะถูก finalize
- เก็บชื่ออ็อบเจกต์ ชื่อฟิลด์ ชื่อรีซอร์ส และ handle ที่ได้รับกลับมาให้คงที่ จนกว่าเอกสารจะเสร็จสมบูรณ์
- การอ้างอิงอ็อบเจกต์ในเอกสารที่โหลดแล้วอาจเป็นแบบ indirect ควร resolve array, dictionary หรือ stream ให้เสร็จก่อนตรวจค่าภายใน