PDFium Component Docs

DestinationCount Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
Komponente: TPdf  ·  Unit: PDFium
Anzahl der im Dokument deklarierten benannten Ziele

Syntax

property DestinationCount: Integer; // read only

Beschreibung

DestinationCount meldet die Anzahl der benannten Ziele, die im Dokument registriert sind, also Einträge, die über das /Dests-Wörterbuch des Katalogs oder seinen /Names /Dests-Namensbaum erreichbar sind (PDF 1.7 Spezifikation Abschnitt 12.3.2.3). Ein benanntes Ziel verknüpft eine Zeichenkettenbeschriftung mit einer Zielseite, einem Ansichtsrechteck und einem optionalen Zoomfaktor; Lesezeichen, Link-Anmerkungen und Remote-Goto-Aktionen verweisen entweder inline oder per Name auf Ziele

Der Wert ist 0, wenn Active False ist oder wenn keine benannten Ziele deklariert sind — Links und Lesezeichen können zwar weiterhin über inline explizite Ziele funktionieren, aber nur die Variante “named” wird in dieser Zählung berücksichtigt. Verwenden Sie Destination[Index] mit Indizes von 0 bis DestinationCount - 1, um einen TDestination-Datensatz zu erhalten, also Handle, Name, Seitennummer, X/Y/Zoom sowie Has-Flags, die angeben, welche Felder explizit gespeichert sind

Die Kosten sind pro Zugriff O(n), weil PDFium den Namensbaum jedes Mal durchläuft. Für wiederholte Suchen nach Namen bevorzugen Sie DestinationByName[Name] gegenüber einer manuellen Schleife — PDFium führt intern eine Suche im ausgeglichenen Baum aus, die besser skaliert als ein linearer Scan

Hinweise

Beispiel

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;

Siehe auch

Destination, DestinationByName, Bookmarks, LinkAnnotationCount