THPDFFDFAnnotationGraph class

Ejer en afgrænset graf af FDF-værdier, dens indirekte objekter og dens annotationsarray

Læsning og skrivning

Decode(Bytes, Options, AllowFields) validerer komplette binære FDF-data og returnerer en graf ejet af kalderen; Encode returnerer kanoniske FDF-bytes med regenererede stream-længder og krydsreference-offsets

AnnotationCount, Annotation, AnnotationPage og ObjectCount inspicerer den admitterede annotationsgraf; Resolve følger graf-scopede indirekte referencer

Det valgfrie dekodningsflag AllowFields admitterer et Fields-array til grafinspektion; det implementerer ikke feltudfyldning eller autoriserer en kun-annotations-adapter til at kassere feltopdateringer

Opbygning

Opret grafen med THPDFFDFOptions, kald StartAnnotations og brug derefter CreateValue, SetScalar, SetStream, AddItem, AddEntry, Define og AppendAnnotation til at konstruere dens værdier

Builder-skalartokens bruger PDF-syntaks, som et slash-præfikseret navn eller en parenteseret streng; dictionary-postnavne er dekodede navnebytes uden indledende slash

Hver værdi tilhører sin graf, og containerposter er lånte; frigør ikke et barn selvstændigt, tilknyt ikke en værdi fra en anden graf og behold ikke en værdi efter frigørelse af dens graf

Konstruerede streams får deres kanoniske Length under enkodning; angiv stream-bytes i stedet for manuelt at konstruere en matchende Length-post

Kontekst og grænser

ActionCount, Action, IsLocalGoTo, IsLocalDestination og LocalDestinationPage inspicerer faktiske annotationshandlingskontekster uden at udføre deres handlinger

Grafmutation invalidaterer cachede handlingskontekster; efterfølgende forespørgsler genopbygger dem under de samme arbejdslager-, dybde- og cancellation-grænser

ReservedBytes rapporterer konservativ admissionsregnskab, mens Reserve tillader en adapter at admittere yderligere grafrelateret lager før allokering

Misdannede referencer, duplikerede dekodede dictionary-navne, ugyldige annotationssider, ikke-admitterede undertyper og overskredne grænser udløser en exception, inden et enkoderet resultat returneres

Se native annotation FDF-udveksling for dokumentniveau-erstatning, tilladelser og publiceringsadfærd