PDFium Delphi Component Docs

DestinationCount Propiedad

Componente: TPdf  ·  Unidad: PDFium
Número de destinos con nombre declarados en el documento

Syntax

property DestinationCount: Integer;// solo lectura

Description

DestinationCount informa del número de destinos con nombre registrados en el documento, es decir, entradas alcanzables a través del diccionario /Dests del catálogo o de su árbol de nombres /Names /Dests (especificación PDF 1.7, sección 12.3.2.3) Un destino con nombre vincula una etiqueta de cadena a una página de destino, un rectángulo de viewport 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 hay destinos con nombre declarados (los enlaces y marcadores pueden seguir funcionando mediante destinos explícitos en línea; solo la variante “con nombre” participa en este recuento) Use Destination[Index] con índices de 0 a DestinationCount - 1 para obtener un registro TDestination (manejador, nombre, número de página, X/Y/Zoom, más marcas de presencia que indican qué campos están almacenados explícitamente)

El coste es O(n) por acceso porque PDFium recorre el árbol de nombres cada vez Para búsquedas repetidas por nombre, prefiera DestinationByName[Name] a un bucle manual — PDFium realiza una búsqueda en árbol equilibrado internamente que escala mejor que un recorrido lineal

Remarks

Example

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;

See Also

Destination, DestinationByName, Bookmarks, LinkAnnotationCount