เมธอด BeginPageObjectEditTransaction

Component: TPdf · Unit: PDFium

เริ่ม edit transaction ระดับ page object ที่ทำซ้ำได้บนเอกสารที่กำลัง active

Syntax

procedure BeginPageObjectEditTransaction(AllowSignedDocument: Boolean = False);

Description

BeginPageObjectEditTransaction เก็บ snapshot ของเอกสารที่ active แบบจำกัดขอบเขตและทำซ้ำได้ แล้วเข้าสู่สถานะ transaction ที่การแก้ไข page object จะถูกบันทึกลง journal ไว้ก่อน แทนที่จะถูกนำไปใช้กับเอกสารทันที

โดยค่าเริ่มต้นคำสั่งนี้จะปฏิเสธเอกสารที่มีลายเซ็น ให้ส่ง AllowSignedDocument = True หากยอมรับความเสี่ยงว่าลายเซ็นเดิมจะใช้ไม่ได้และยังต้องการเปิด transaction

Remarks

ติดตามความคืบหน้าผ่าน PageObjectEditTransactionStatus ระหว่างที่ transaction เปิดอยู่
เรียก CommitPageObjectEditTransaction เพื่อนำการแก้ไขที่บันทึกไว้ไปใช้ หรือ RollbackPageObjectEditTransaction เพื่อกลับไปยัง snapshot เดิม
ไม่รองรับ transaction ซ้อนกัน ให้เริ่มอันถัดไปหลัง commit หรือ rollback เสร็จเท่านั้น

Example

ครอบกลุ่มการแก้ไข object ไว้ด้วยกัน เพื่อให้ย้อนกลับได้ทั้งชุดเดียว

Pdf1.BeginPageObjectEditTransaction;
try
  Pdf1.SetTextObjectFontSize(3, 14);
  if not Pdf1.CommitPageObjectEditTransaction then Pdf1.RollbackPageObjectEditTransaction;
finally
  Pdf1.UpdatePage(1);
end;