PDFium Delphi Component Docs

DestinationCount Propriété

Composant: TPdf  ·  Unit: PDFium
Nombre de destinations nommées déclarées dans le document

Syntax

property DestinationCount: Integer; // read only

Description

DestinationCount indique le nombre de destinations nommées enregistrées avec le document, c’est-à-dire les entrées accessibles via le dictionnaire /Dests ou son arbre de noms /Names /Dests (spécification PDF 1.7, section 12.3.2.3). Une destination nommée lie une étiquette de type chaîne à une page cible, un rectangle de viewport et un facteur de zoom facultatif ; les signets, les annotations de lien et les actions remote-goto référencent les destinations soit en ligne, soit par nom

La valeur est 0 quand Active vaut False ou lorsqu’aucune destination nommée n’est déclarée (les liens et signets peuvent encore fonctionner via des destinations explicites en ligne ; seule la variante « nommée » participe à ce comptage). Utilisez Destination[Index] avec des indices de 0 à DestinationCount - 1 pour obtenir un enregistrement TDestination (handle, nom, numéro de page, X/Y/Zoom, plus des has-flags indiquant quels champs sont explicitement stockés)

Le coût est en O(n) par accès car PDFium parcourt l’arbre de noms à chaque fois. Pour des recherches répétées par nom, préférez DestinationByName[Name] à une boucle manuelle — PDFium effectue en interne une recherche dans un arbre équilibré, qui passe mieux à l’échelle qu’un balayage linéaire

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