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