PDFium Component Docs

DestinationCount Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdf  ·  Unit: PDFium
Aantal named destinations dat in het document is gedeclareerd

Syntaxis

property DestinationCount: Integer; // read only

Beschrijving

DestinationCount rapporteert het aantal named destinations dat bij het document is geregistreerd, dat wil zeggen de vermeldingen die bereikbaar zijn via de /Dests-dictionary van de catalogus of via de naamboom /Names /Dests (PDF 1.7 spec section 12.3.2.3) Een named destination koppelt een tekenreekslabel aan een doelpagina, een viewportrechthoek en een optionele zoomfactor; bookmarks, link annotations en remote-goto actions verwijzen naar destinations inline of via naam

De waarde is 0 wanneer Active False is of wanneer geen named destinations zijn gedeclareerd (links en bookmarks kunnen nog steeds werken via inline expliciete destinations; alleen de “named” variant telt mee in deze telling) Gebruik Destination[Index] met indexen van 0 tot DestinationCount - 1 om een TDestination-record te krijgen (handle, naam, paginanummer, X/Y/Zoom, plus has-vlaggen die aangeven welke velden expliciet zijn opgeslagen)

De kost is O(n) per toegang omdat PDFium elke keer de naamboom doorloopt. Gebruik voor herhaalde opvragingen op naam liever DestinationByName[Name] dan een handmatige loop — PDFium voert intern een balanced-tree search uit die beter schaalt dan een lineaire scan

Opmerkingen

Voorbeeld

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;

Zie ook

Destination, DestinationByName, Bookmarks, LinkAnnotationCount