DestinationCount Eigenschaft

DestinationCount meldet die Anzahl der im Dokument registrierten named destinations, also der Einträge, die über das /Dests-Dictionary des Katalogs oder seinen /Names /Dests-Name-Tree erreichbar sind (PDF 1.7 spec section 12.3.2.3) Eine named destination bindet ein String-Label an eine Zielseite, ein Viewport-Rechteck und einen optionalen Zoomfaktor; Lesezeichen, Link-Annotationen und Remote-Goto-Aktionen referenzieren Ziele inline oder über den Namen

Der Wert ist 0, wenn Active False ist oder keine named destinations deklariert sind (Links und Lesezeichen funktionieren dann noch über inline explicit destinations; nur die “benannte” Variante geht in diese Zählung ein) Mit Destination[Index] und Indizes von 0 bis DestinationCount - 1 holen Sie einen TDestination-Record (Handle, Name, Seitennummer, X/Y/Zoom, plus Has-Flags, die angeben, welche Felder explizit gespeichert sind)

Der Zugriff kostet O(n) je Aufruf, weil PDFium jedes Mal den Name-Tree durchläuft Für wiederholte Suchen per Name DestinationByName[Name] einer manuellen Schleife vorziehen — PDFium macht intern eine Balancierte-Baum-Suche, die besser skaliert als eine lineare Abtastung

• Named destinations erzeugen Autoren-Werkzeuge typischerweise automatisch für Querverweise (Abbildungsnummern, Formel-Labels, Glossarbegriffe)
• An diesem Wert lässt sich das Maß an “strukturierter Querverlinkung” eines PDFs ablesen — Berichte und Bücher haben oft Hunderte von Zielen, gescannte Rechnungen meist null
• Wer nur einem Outline-Baum folgen will, fährt mit der Eigenschaft Bookmarks direkter; named destinations sind vor allem relevant, wenn es um Remote-Referenzen aus anderen PDFs geht