รีเคิร์ด THPDFLayoutDiagnosticOptions

สวิตช์และเพดานงบสำหรับ layout diagnostics: การเก็บ element-path และตำแหน่งในซอร์ส, การตรวจจับ overlap, การวาด overlay กับป้ายกำกับ, การแจ้งเตือน live preview และลิมิตการติดตาม

การประกาศ

THPDFLayoutDiagnosticOptions= record
  CaptureElementPath: boolean;
  CaptureSourceLocation: boolean;
  DetectOverlaps: boolean;
  DrawOverlays: boolean;
  ShowOverlayLabels: boolean;
  LivePreview: boolean;
  MaxTrackedBounds: Integer;
  MaxOverlapComparisons: Int64;
  class function Default: THPDFLayoutDiagnosticOptions; static;
end;

ยูนิต

HPDFDoc

ฟิลด์

ฟิลด์	วัตถุประสงค์
`CaptureElementPath`	เก็บสตริง `ElementPath` ของแต่ละรายการวินิจฉัย ค่าเริ่มต้น `True`
`CaptureSourceLocation`	เก็บไฟล์ซอร์ส บรรทัด และคอลัมน์ที่ผูกกับ element ค่าเริ่มต้น `False`
`DetectOverlaps`	ติดตามสี่เหลี่ยมที่วางแล้วและเทียบกันเป็นคู่ ๆ หา overlap ค่าเริ่มต้น `False`
`DrawOverlays`	วาดสี่เหลี่ยมวินิจฉัยลงบนหน้าขณะ render ค่าเริ่มต้น `False`
`ShowOverlayLabels`	ใส่ข้อความเหตุผลกำกับ overlay ที่วาดแล้ว ค่าเริ่มต้น `True`
`LivePreview`	ส่งการแจ้งเตือนแบบวินิจฉัยระหว่างแก้ไขแบบโต้ตอบ ค่าเริ่มต้น `False`
`MaxTrackedBounds`	จำนวนสี่เหลี่ยมสูงสุดที่เก็บไว้ใช้ติดตามและเช็ก overlap ค่าเริ่มต้น `4096`
`MaxOverlapComparisons`	จำนวนการเทียบสี่เหลี่ยมเป็นคู่สูงสุดต่อรอบก่อนที่การตรวจจับจะหยุด ค่าเริ่มต้น `1000000`
`Default`	class function ที่คืนค่าตามรายการข้างบน

หมายเหตุการใช้งาน

เริ่มจาก THPDFLayoutDiagnosticOptions.Default แก้เฉพาะสวิตช์ที่ต้องใช้ แล้วกำหนดค่าผ่าน THotPDF.SetLayoutDiagnosticOptions หรือพร็อพเพอร์ตี้ LayoutDiagnosticOptions
เปิด DetectOverlaps เฉพาะช่วง layout run ที่สนใจเท่านั้น: การเทียบถูกจำกัดด้วย MaxOverlapComparisons แต่ก็ยังกินเวลากับเอกสารใหญ่ ๆ
ใช้ DrawOverlays คู่กับ ShowOverlayLabels สำหรับ debug ด้วยตา แล้วอ่าน THPDFLayoutDiagnosticStatistics เพื่อดูว่ามีอะไรถูกติดตาม เทียบ และวาดไปบ้าง

รีเคิร์ด THPDFLayoutDiagnosticOptions

การประกาศ

ยูนิต

ฟิลด์

หมายเหตุการใช้งาน

API ที่เกี่ยวข้อง