DestinationCount property

DestinationCount rapporterer antallet af navngivne destinationer registreret hos dokumentet, dvs. poster der er nåbare gennem katalogens /Dests-dictionary eller dens /Names /Dests-navnetræ (PDF 1.7-specifikationen afsnit 12.3.2.3). En navngiven destination binder et strengmærke til en mål-side, et viewport-rektangel og en valgfri zoom-faktor; bogmærker, link-annotationer og remote-goto-handlinger refererer til destinationer enten inline eller efter navn.

Værdien er 0, når Active er False, eller når ingen navngivne destinationer er erklæret (links og bogmærker kan stadig fungere via inline eksplicitte destinationer; kun den “navngivne” variant deltager i dette tal). Brug Destination[Index] med indekser fra 0 til DestinationCount - 1 for at hente en TDestination-post (handle, navn, sidenummer, X/Y/Zoom plus has-flag der angiver hvilke felter der er eksplicit gemt).

Omkostningen er O(n) pr. adgang, fordi PDFium gennemløber navnetræet hver gang. Til gentagne opslag efter navn, foretræk DestinationByName[Name] frem for en manuel løkke — PDFium udfører en balanceret-træ-søgning internt, som skalerer bedre end en lineær scanning.

• Navngivne destinationer genereres typisk automatisk af forfatterværktøjer til krydsreferencer (figurnumre, ligningsmærker, ordlister).
• Brug denne værdi til at estimere “struktureret kryds-linking”-niveauet for en PDF — rapporter og bøger har ofte hundredevis af destinationer, scannede fakturaer har normalt nul.
• Hvis du kun skal følge et outline-træ, er Bookmarks-egenskaben mere direkte; navngivne destinationer er hovedsageligt relevante ved håndtering af fjernreferencer fra andre PDF'er.