THPDFFDFAnnotationGraph class

Unit: HPDFFDFAnnotations

Jest właścicielem ograniczonego grafu wartości FDF, jego pośrednich obiektów i jego tablicy adnotacji

Czytanie i pisanie

Decode(Bytes, Options, AllowFields) waliduje kompletny binarny FDF i zwraca graf będący własnością wywołującego; Encode zwraca kanoniczne bajty FDF z regenerowanymi długościami strumieni i offsetami odwołań krzyżowych

AnnotationCount, Annotation, AnnotationPage i ObjectCount inspectują dopuszczony graf adnotacji; Resolve podąża za pośrednimi referencjami w zakresie grafu

Opcjonalny flag dekodowania AllowFields dopuszcza tablicę Fields do inspekcji grafu; nie implementuje wypełniania pól ani nie upoważnia adaptera tylko-adnotacyjnego do wyrzucania aktualizacji pól

Budowanie

Utwórz graf z THPDFFDFOptions, wywołaj StartAnnotations, po czym użyj CreateValue, SetScalar, SetStream, AddItem, AddEntry, Define i AppendAnnotation, by zbudować jego wartości

Tokeny skalarne buildera używają składni PDF, jak nazwa z ukośnikiem na początku albo string w nawiasach; nazwy entrów słowników to zdekodowane bajty nazw bez wiodącego ukośnika

Każda wartość należy do swojego grafu, a entre kontenerów są pożyczone; nie free'uj potomka samodzielnie, nie wpinaj wartości z innego grafu i nie zachowuj wartości po free'owaniu jej grafu

Skonstruowane strumienie otrzymują swoją kanoniczną Length podczas kodowania; dostarcz bajty strumienia zamiast ręcznie konstruować matchujący entre Length

Kontekst i limity

ActionCount, Action, IsLocalGoTo, IsLocalDestination i LocalDestinationPage inspectują rzeczywiste konteksty akcji adnotacji bez wykonywania tych akcji

Mutacja grafu unieważnia cache'owane konteksty akcji; kolejne query odbudowują je pod tymi samymi limitami magazynu roboczego, głębokości i anulowania

ReservedBytes raportuje konserwatywną księgowość dopuszczania, podczas gdy Reserve pozwala adapterowi dopuścić dodatkowy magazyn związany z grafem przed alokacją

Zniekształcone referencje, zdublowane zdekodowane nazwy słowników, niepoprawne strony adnotacji, niedopuszczalne subtypy i przekroczone limity podnoszą wyjątek, zanim zostanie zwrócony zakodowany wynik

Zobacz natywną wymianę FDF adnotacji dla zachowania podmiany, uprawnień i publikacji na poziomie dokumentu