PDFium Component Docs

DestinationCount Właściwość

Component: TPdf  ·  Unit: PDFium
Liczba nazwanych celów zadeklarowanych w dokumencie

Syntax

property DestinationCount: Integer; // read only

Description

DestinationCount podaje liczbę celów nazwanych zarejestrowanych w dokumencie, czyli wpisów osiągalnych przez słownik /Dests katalogu lub jego drzewo nazw /Names /Dests (spec PDF 1.7, sekcja 12.3.2.3) Cel nazwany wiąże etykietę tekstową ze stroną docelową, prostokątem widoku i opcjonalnym współczynnikiem powiększenia; zakładki, adnotacje łączy i akcje remote-goto odwołują się do celów bezpośrednio lub po nazwie

Wartość wynosi 0, gdy Active ma wartość False lub gdy nie zadeklarowano celów nazwanych (łącza i zakładki mogą nadal działać przez bezpośrednie cele jawne; w tej liczbie uczestniczy tylko odmiana „nazwana”) Użyj Destination[Index] z indeksami od 0 do DestinationCount - 1, aby uzyskać rekord TDestination (uchwyt, nazwa, numer strony, X/Y/Zoom oraz flagi has- wskazujące, które pola są jawnie zapisane)

Koszt wynosi O(n) na dostęp, ponieważ PDFium za każdym razem przechodzi drzewo nazw Przy powtarzających się wyszukiwaniach po nazwie preferuj DestinationByName[Name] zamiast ręcznej pętli — PDFium wykonuje wewnętrznie wyszukiwanie w zbalansowanym drzewie, które skaluje się lepiej niż liniowe skanowanie

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