property DestinationCount: Integer; // read only
DestinationCount riporta il numero di destinazioni nominate registrate nel
documento, cioè le voci raggiungibili tramite il dizionario /Dests del catalogo
o il suo name tree /Names /Dests (sezione 12.3.2.3 della specifica PDF 1.7).
Una destinazione nominata lega un'etichetta stringa a una pagina di destinazione, a un rettangolo viewport e a un
fattore di zoom opzionale; segnalibri, annotazioni link e azioni remote-goto referenziano le
destinazioni inline o per nome
Il valore è 0 quando Active è False o quando
non sono dichiarate destinazioni nominate (link e segnalibri possono comunque funzionare tramite destinazioni
esplicite inline; solo la variante “nominata” partecipa a questo conteggio).
Usa Destination[Index] con indici da 0 a
DestinationCount - 1 per ottenere un record TDestination
(handle, nome, numero di pagina, X/Y/Zoom, più flag has- che indicano quali campi sono
memorizzati esplicitamente)
Il costo è O(n) per accesso perché PDFium percorre il name tree ogni volta.
Per ricerche ripetute per nome, preferisci DestinationByName[Name] a un ciclo
manuale — PDFium esegue internamente una ricerca su albero bilanciato che scala meglio di
una scansione lineare
Bookmarks
è più diretta; le destinazioni nominate sono rilevanti soprattutto quando gestisci riferimenti
remoti da altri PDF
var I: Integer;
var D: TDestination;
for I := 0 to Pdf1.DestinationCount - 1 do
begin
D := Pdf1.Destination[I];
Memo1.Lines.Add(Format('%s → page %d', [D.Name, D.PageNumber]));
end;