DestinationCount-egenskap

DestinationCount rapporterer antall navngitte destinasjoner registrert hos dokumentet, dvs. oppføringer som kan nås gjennom katalogens /Dests-ordbok eller dens /Names /Dests-navnetre (PDF 1.7-spesifikasjonen avsnitt 12.3.2.3). En navngitt destinasjon binder en streng-etikett til en målside, et visningsområde-rektangel og en valgfri zoom-faktor; bokmerker, lenkemerknader og eksterne goto-handlinger refererer til destinasjoner enten innebygd eller etter navn.

Verdien er 0 når Active er False eller når ingen navngitte destinasjoner deklareres (lenker og bokmerker kan fortsatt fungere via innebygde eksplisitte destinasjoner; kun den “navngitte”-varianten deltar i dette antallet). Bruk Destination[Index] med indekser fra 0 til DestinationCount - 1 for å oppnå en TDestination-post (handle, navn, sidenummer, X/Y/Zoom, pluss has-flagg som indikerer hvilke felt som er eksplisitt lagret).

Kostnaden er O(n) per tilgang fordi PDFium går gjennom navnetreet hver gang. For gjentatte oppslag etter navn, foretrekk DestinationByName[Name] fremfor en manuell løkke — PDFium utfører et balansert-tre-søk internt som skalerer bedre enn en lineær skanning.

• Navngitte destinasjoner blir typisk auto-generert av redigeringsverktøy for kryssreferanser (figurnumre, ligningsetiketter, glossar-termer).
• Bruk denne verdien til å anslå “strukturelt kryss-lenking”-nivået til en PDF — rapporter og bøker har ofte hundrevis av destinasjoner, skannede fakturaer har vanligvis null.
• Hvis du kun trenger å følge et disposisjonstre, er Bookmarks-egenskapen mer direkte; navngitte destinasjoner er hovedsakelig relevante ved håndtering av eksterne referanser fra andre PDF-er.