DestinationCount Egenskap

DestinationCount rapporterar antalet namngivna mål som är registrerade hos dokumentet, dvs. poster som kan nås via katalogens /Dests-ordbok eller dess /Names /Dests-namnträd (PDF 1.7 spec avsnitt 12.3.2.3). Ett namngivet mål binder en strängetikett till en målsida, en vyportsrektangel och en valfri zoomfaktor; bokmärken, länkannoteringar och fjärrgoto-åtgärder refererar till mål antingen inline eller med namn

Värdet är 0 när Active är False eller när inga namngivna mål deklareras (länkar och bokmärken kan fortfarande fungera via explicita inline-mål; endast varianten “namngiven” räknas med här). Använd Destination[Index] med index från 0 till DestinationCount - 1 för att erhålla en TDestination-post (handtag, namn, sidnummer, X/Y/Zoom samt has-flaggor som anger vilka fält som uttryckligen lagras)

Kostnaden är O(n) per åtkomst eftersom PDFium går igenom namnträdet varje gång. Vid upprepade uppslagningar med namn, föredra DestinationByName[Name] framför en manuell loop — PDFium utför internt en balanserad trädsökning som skalas bättre än en linjär sökning

• Namngivna mål genereras typiskt automatiskt av framställningsverktyg för korsreferenser (figurnummer, ekvationsetiketter, ordlistetermer)
• Använd detta värde för att uppskatta nivån av “strukturerad korslänkning” i en PDF — rapporter och böcker har ofta hundratals mål, inskannade fakturor har vanligtvis noll
• Om du bara behöver följa ett dispositionsträd är egenskapen Bookmarks mer direkt; namngivna mål är främst relevanta vid hantering av fjärrreferenser från andra PDF-filer