property DestinationCount: Integer; // read only
DestinationCount informa el número de destinos nombrados registrados en
el documento, es decir, las entradas accesibles mediante el diccionario /Dests
del catálogo o su árbol de nombres /Names /Dests (sección 12.3.2.3 de la
especificación PDF 1.7)
Un destino nombrado vincula una etiqueta de cadena con una página de destino, un rectángulo de visualización y un
factor de zoom opcional; los marcadores, las anotaciones de enlace y las acciones de salto remoto hacen referencia a los
destinos ya sea en línea o por nombre
El valor es 0 cuando Active es False o cuando
no se declaran destinos nombrados (los enlaces y marcadores pueden seguir funcionando mediante
destinos explícitos en línea; solo la variante “nombrada” participa en este conteo)
Use Destination[Index] con índices de 0 a
DestinationCount - 1 para obtener un registro TDestination
(identificador, nombre, número de página, X/Y/Zoom, más banderas que indican qué campos están
almacenados explícitamente)
El costo es O(n) por acceso porque PDFium recorre el árbol de nombres cada vez
Para búsquedas repetidas por nombre, prefiera DestinationByName[Name] en lugar de un
ciclo manual — PDFium realiza internamente una búsqueda en árbol balanceado que escala mejor que
un recorrido lineal
Bookmarks
es más directa; los destinos nombrados son relevantes principalmente al manejar referencias
remotas desde otros 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;