THotPDF.AddLoadedTextField Method
เพิ่ม text field ลงบนหน้าหนึ่งของเอกสารที่โหลดไว้ และ register ลงใน AcroForm ฟิลด์จะได้ appearance stream ที่แสดงค่าของมัน และ AcroForm จะได้ฟอนต์ default Helvetica ที่ string /DA อ้างถึง ทุก viewer จึงแสดงฟิลด์ได้
การประกาศ
function AddLoadedTextField(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; AMaxLen: Integer): 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 | ค่าเริ่มต้น ถ้าว่างคือฟิลด์เปล่า |
AMaxLen | จำนวนอักขระสูงสุด หรือ 0 ถ้าไม่จำกัด |
ค่าที่ส่งกลับ
ดัชนีของฟิลด์ใหม่ ใช้กับ method จัดการ form field ของเอกสารที่โหลดไว้ตัวอื่น หรือ -1 เมื่อ PageIndex อยู่นอกช่วง
การใช้งาน
- ใช้ API นี้ใน workflow ของ AcroForm ก่อนที่หน้า resource ฟิลด์ หรือ object catalog ที่ได้รับผลจะถูก finalize
- เก็บชื่ออ็อบเจกต์ ชื่อฟิลด์ ชื่อรีซอร์ส และ handle ที่ได้รับกลับมาให้คงที่ จนกว่าเอกสารจะเสร็จสมบูรณ์
- การอ้างอิงอ็อบเจกต์ในเอกสารที่โหลดแล้วอาจเป็นแบบ indirect ควร resolve array, dictionary หรือ stream ให้เสร็จก่อนตรวจค่าภายใน