PDFium Delphi Component Docs

اجتياز البنية والذاكرة المؤقتة

المكوّن: TPdf  ·  الوحدة: PDFium
اقرأ بنية PDF الموسومة تزايديًا أو أعد استخدام لقطات صفحات كاملة واعية بالمراجعة۔

ReadStructureElements

function ReadStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; out Status: TPdfStructureReadStatus): TPdfStructureElements;

يستخدم اجتيازًا تكراريًا عقدة أصل أولًا ويعيد لقطة مسطَّحة يملكها المستدعي بقيم Level و ParentIndex مستقرة

يبلّغ كل TPdfStructureElement أيضًا عن حقائق التسلسل الهرمي عبر MarkedContentIDs و ChildCount و ChildMarkedContentIDs و AttributeCount، وعن بنية الجداول عبر HasHeaders و HeadersIds و ColSpan، وعن حارسَي الطباعة والمرجع HasPrintField و HasReference

يتكشف إسقاط الأدوار عبر RoleMappedNamespaceUri و RoleMappedTypeName، والملفات المرتبطة عبر HasAssociatedFile و AssociatedFileRelationship و AssociatedFileDescription و AssociatedFileDeclaredInCatalog و AssociatedFileDeclaredInStructure و AssociatedFileInEmbeddedFilesNameTree و AssociatedFileHasReadingOrder و AssociatedFileReadingOrderIndex، وحقائق التعليقات عبر AnnotationSubtype و AnnotationContents و AnnotationAlternateText و IsArtifact وحارسَي الأدوات WidgetCount و HasAppearance، وعبر FieldAlternateName

تقيّد MaxDepth و MaxElements و MaxAttributeValues و DeadlineMilliseconds العمل الأصلي والتخصيص المُدار

يُبقي IncludeAttributes=False نص البنية والتسلسل الهرمي و MCIDs مع تخطي تجسيد قيم السمات

يكون Status.Completed يساوي false عند بلوغ أي ميزانية أو انقضاء المهلة أو إيقاف زائر للاجتياز

يعدّ Status.ElementsVisited و Status.AttributeValuesVisited العمل المنجز، بينما يحدد Status.DepthLimitReached و Status.ElementLimitReached و Status.AttributeLimitReached و Status.DeadlineReached الميزانية التي أوقفت المشوار

VisitStructureElements

function VisitStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; Visitor: TPdfStructureElementVisitor; out Status: TPdfStructureReadStatus): Integer;

يستدعي Visitor مرة واحدة لكل عنصر دون تخصيص مصفوفة الصفحة كاملة

اضبط معامل KeepGoing في الاستدعاء على false لإيقاف مبكر عادي يُبلَّغ عنه عبر Status.VisitorStopped

يستلم كل استدعاء بيانات عنصر مُدارة يمكن الاحتفاظ بها بعد عودة الاستدعاء، ولا يُكشف أي مقبض بنية أصلي

StructureElementsForPage

property StructureElementsForPage[PageNumber: Integer]: TPdfStructureElements; // read only

يقرأ أي صفحة بترقيم يبدأ من واحد دون تغيير PageNumber أو إطلاق OnPageChange

تدخل النتائج المكتملة بالميزانية الافتراضية ذاكرة LRU المشتركة التي يستخدمها StructureElements و TPdfView.StructureElements والمحتوى القابل للقراءة وإعادة التدفق والنص المهيكل والتحقق من الوصولية

تُنسخ المصفوفات الديناميكية المتداخلة وكتل السمات نسخًا عميقًا فلا يستطيع تعديل لقطة معادة تغيير الذاكرة أو ملف PDF

StructureCacheCapacity

property StructureCacheCapacity: Integer; // read and write, default 8

يحدد عدد لقطات الصفحات الكاملة المحتفظ بها بترتيب الأقل استخدامًا مؤخرًا

اضبط السعة على صفر لتحرير اللقطات المخزنة وتعطيل التخزين مستقبلًا

ترفع قيم السعة السالبة EPdfError

StructureCacheCount

property StructureCacheCount: Integer; // read only

يعيد العدد الحالي للقطات الصالحة لصفحات المستند

StructureCacheHitCount و StructureCacheMissCount

property StructureCacheHitCount: Int64; // read only
property StructureCacheMissCount: Int64; // read only

تكشف قياسات البحث التراكمية عن نسخة المكوّن

تُبطل التحريرات الصفحة المتأثرة أو الذاكرة كاملة مع حفظ العدادات التراكمية

الميزانيات الافتراضية

MaxDepth256
MaxElements100000
MaxAttributeValues100000
DeadlineMilliseconds0 بلا مهلة
IncludeAttributesTrue

انظر أيضًا

StructureElements, ReadableContent, ValidatePdfUaStructureElements