property DestinationCount: Integer; // read only
DestinationCount informa o número de destinos nomeados registrados com
o documento, ou seja, entradas acessíveis através do dicionário /Dests
do catálogo ou sua árvore de nomes /Names /Dests (especificação PDF 1.7 seção 12.3.2.3)
Um destino nomeado associa um rótulo de string a uma página alvo, um retângulo de viewport e
fator de zoom opcional; marcadores, anotações de link e ações remote-goto referenciam
destinos inline ou por nome.
O valor é 0 quando Active é False ou quando
nenhum destino nomeado é declarado (links e marcadores ainda podem funcionar via
destinos explícitos inline; apenas a variante “nomeada” participa desta contagem)
Use Destination[Index] com índices de 0 a
DestinationCount - 1 para obter um registro TDestination
(handle, nome, número da página, X/Y/Zoom, mais flags indicando quais campos estão
armazenados explicitamente).
O custo é O(n) por acesso porque o PDFium percorre a árvore de nomes cada vez
Para consultas repetidas por nome, prefira DestinationByName[Name] em vez de um loop
manual — o PDFium realiza uma busca em árvore balanceada internamente que escala melhor do que
uma varredura linear.
Bookmarks
é mais direta; destinos nomeados são relevantes principalmente ao lidar com referências
remotas de outros PDFs.
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;