PDFium Component Docs

DestinationCount Właściwość

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.
Komponent: TPdf  ·  Moduł: PDFium
Liczba nazwanych celów zadeklarowanych w dokumencie

Składnia

property DestinationCount: Integer; // read only

Opis

DestinationCount podaje liczbę nazwanych celów zarejestrowanych w dokumencie, czyli wpisów osiągalnych przez słownik /Dests katalogu albo jego drzewo nazw /Names /Dests (sekcja 12.3.2.3 specyfikacji PDF 1.7) Nazwany cel wiąże etykietę tekstową z docelową stroną, prostokątem widoku i opcjonalnym współczynnikiem powiększenia; zakładki, adnotacje odsyłaczy i akcje przejścia zdalnego odwołują się do celów albo jawnie, albo po nazwie

Wartość wynosi 0, gdy Active ma wartość False albo gdy nie zadeklarowano żadnych nazwanych celów (linki i zakładki mogą nadal działać dzięki jawnie zapisanym celom inline; tylko odmiana „nazwana” uczestniczy w tym zliczaniu) Użyj Destination[Index] z indeksami od 0 do DestinationCount - 1, aby otrzymać rekord TDestination (uchwyt, nazwa, numer strony, X/Y/Zoom oraz znaczniki has wskazujące, które pola są zapisane jawnie)

Koszt wynosi O(n) na każdy dostęp, ponieważ PDFium za każdym razem przechodzi przez drzewo nazw Dla wielokrotnych wyszukiwań po nazwie lepiej użyć DestinationByName[Name] zamiast ręcznej pętli — PDFium wykonuje wewnętrznie wyszukiwanie w zrównoważonym drzewie, które skaluje się lepiej niż liniowe skanowanie

Uwagi

Przykład

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;

Zobacz też

Destination, DestinationByName, Bookmarks, LinkAnnotationCount