السجل THPDFLayoutDiagnostic
حدث تخطيط بنيوي واحد: ماذا حدث ولماذا، والصفحة والمستطيل المعنيان، وعدد الأسطر، ومسارات العناصر، والموضع الاختياري للعنصر في الشيفرة المصدرية
التصريح
THPDFLayoutDiagnostic= record
Kind: THPDFLayoutDiagnosticKind;
PageIndex: Integer;
RelatedPageIndex: Integer;
X: Single;
Y: Single;
Width: Single;
Height: Single;
LineCount: Integer;
Reason: AnsiString;
ElementPath: AnsiString;
RelatedElementPath: AnsiString;
SourceFile: AnsiString;
SourceLine: Integer;
SourceColumn: Integer;
end;
الوحدة
HPDFDoc
الحقول
| الحقل | الغرض |
|---|---|
Kind | نوع حدث THPDFLayoutDiagnosticKind، مثل ldkAutomaticPageBreak أو ldkKeepWithNext |
PageIndex | الصفحة التي وقع فيها الحدث، بفهرس يبدأ من صفر |
RelatedPageIndex | الصفحة المقترنة للأحداث العابرة للصفحات، مثل انقسام عنصر إلى الصفحة التالية |
X / Y / Width / Height | مستطيل الوضع المعني بالحدث، وبالمقاييس نفسها المستخدمة في THPDFLayoutBounds |
LineCount | عدد أسطر النص المعنية، مثل الأسطر الموزعة قبل فصل تلقائي |
Reason | شرح مقروء لسبب تسجيل الحدث |
ElementPath | مسار عنصر التخطيط الذي ينتمي إليه الحدث |
RelatedElementPath | مسار العنصر المقترن في أحداث التداخل والانقسام |
SourceFile / SourceLine / SourceColumn | موضع التصريح الملتقط عبر SetDiagnosticSource عند تفعيل التقاط موضع المصدر |
ملاحظات الاستخدام
- ينتج محرك التخطيط السجلات أثناء تفعيل التشخيصات ويُسلّمها عبر
THotPDF.GetLayoutDiagnosticsأوTHotPDF.GetLayoutDiagnosticأو حدثOnLayoutDiagnostic - استخدم
KindمعElementPathللتصفية، وReasonللعرض المباشر في السجلات أو قوائم المشكلات - تغذي حقول المستطيل
THotPDF.DrawLayoutDiagnosticOverlayبحيث تُصوَّر الأحداث مباشرة على الصفحة المصيَّرة