Třída THPDFFDFAnnotationGraph

Unit: HPDFFDFAnnotations

Vlastní ohraničený graf hodnot FDF, jeho nepřímé objekty a jeho pole anotací

Čtení a zápis

Decode(Bytes, Options, AllowFields) validuje kompletní binární data FDF a vrací graf vlastněný volajícím; Encode vrací kanonické bajty FDF s regenerovanými délkami streamů a offsety křížových referencí

AnnotationCount, Annotation, AnnotationPage a ObjectCount prohlíží přijatý anotační graf; Resolve následuje nepřímé reference v rozsahu grafu

Volitelný dekódovací příznak AllowFields přijímá pole Fields k prohlížení grafu; neimplementuje vyplňování polí ani neautorizuje anotační adaptér k zahazování aktualizací polí

Stavba

Vytvořte graf s THPDFFDFOptions, zavolejte StartAnnotations a pak použijte CreateValue, SetScalar, SetStream, AddItem, AddEntry, Define a AppendAnnotation ke konstrukci jeho hodnot

Skalární tokeny builderu používají syntaxi PDF, například název s lomítkem či řetězec v závorkách; názvy položek slovníku jsou dekódované bajty názvů bez úvodního lomítka

Každá hodnota patří svému grafu a položky kontejnerů jsou vypůjčené; neuvolňujte potomka samostatně, nepřipojujte hodnotu z jiného grafu a nezachovávejte hodnotu po uvolnění jejího grafu

Konstruované streamy dostanou svou kanonickou Length během kódování; dodávejte bajty streamu místo ruční konstrukce odpovídající položky Length

Kontext a meze

ActionCount, Action, IsLocalGoTo, IsLocalDestination a LocalDestinationPage prohlíží skutečné kontexty akcí anotací bez vykonávání jejich akcí

Mutace grafu zneplatní cacheované kontexty akcí; následné dotazy je znovu sestaví pod stejnými limity pracovního úložiště, hloubky a zrušení

ReservedBytes hlásí konzervativní účetnictví admise, zatímco Reserve dovoluje adaptéru přijmout dodatečné úložiště související s grafem před alokací

Poškozené reference, duplicitní dekódované názvy slovníků, neplatné anotační stránky, nepřípustné podtypy a překročené limity vyvolají výjimku dřív, než se vrátí kódovaný výsledek

Viz nativní výměna anotací FDF pro náhradu na úrovni dokumentu, oprávnění a chování publikace