DestinationCount eigenschap

DestinationCount rapporteert het aantal benoemde bestemmingen dat bij het document is geregistreerd, dwz entries die bereikbaar zijn via het /Dests-woordenboek van de catalogus of de naamboom /Names /Dests (PDF 1.7-specificatie sectie 12.3.2.3). Een benoemde bestemming koppelt een tekenreekslabel aan een doelpagina, een viewport-rechthoek en een optionele zoomfactor; bladwijzers, link-annotaties en remote-goto-acties verwijzen naar bestemmingen hetzij inline hetzij op naam.

De waarde is 0 wanneer Active False is of wanneer er geen benoemde bestemmingen zijn gedeclareerd (links en bladwijzers kunnen nog steeds werken via inline expliciete bestemmingen; alleen de “benoemde” variant neemt deel aan dit aantal). Gebruik Destination[Index] met indexen van 0 tot en met DestinationCount - 1 om een TDestination-record te verkrijgen (handle, naam, paginanummer, X/Y/Zoom, plus has-flags die aangeven welke velden expliciet zijn opgeslagen).

De kosten zijn O(n) per toegang omdat PDFium de naamboom telkens doorloopt. Voor herhaalde opzoeken op naam geeft u de voorkeur aan DestinationByName[Name] boven een handmatige loop — PDFium voert intern een gebalanceerde-boomzoekactie uit die beter schaalt dan een lineaire scan.

• Benoemde bestemmingen worden doorgaans automatisch gegenereerd door auteurstools voor kruisverwijzingen (figuurnummers, vergelijkingslabels, woordenlijsttermen).
• Gebruik deze waarde om het “gestructureerde kruiskoppelings”-niveau van een PDF in te schatten — rapporten en boeken hebben vaak honderden bestemmingen, gescande facturen meestal nul.
• Als u alleen een outline-boom hoeft te volgen, is de eigenschap Bookmarks directer; benoemde bestemmingen zijn vooral relevant bij het verwerken van remote referenties van andere PDF's.