THPDFPage.AddStructureDestinationLink Method

Dodaje adnotację linku, której akcja GoTo niesie wymagany zapasowy cel /D we współrzędnych strony oraz PDF 2.0 tablicę /SD nazywającą docelowy StructElem przez referencję pośrednią, dzięki czemu czytniki PDF 2.0 przeskoczą do treści struktury, a starsze czytniki cofną się do wskazanej strony

Deklaracja

procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
  FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');

Jednostka

HPDFDoc

Parametry

Nazwa	Przeznaczenie
`Rectangle`	Prostokąt aktywnego obszaru linku w jednostkach strony
`StructElem`	Nie-nilowy pośredni słownik StructElem będący celem, typowo z `AddStructureElement` lub `FindStructureElementForMCID`
`FallbackPageIndex`	Wymagany indeks strony używany przez jawny cel `/D` dla czytników bez obsługi PDF 2.0
`YPos`	Opcjonalna pozycja pionowa dla dopasowania `/XYZ`; podaj wartość ujemną, aby pozostawić ją pustą
`Description`	Opis alternatywny zapisywany w `/Contents` adnotacji; wymagany przy `PDFUACompliance`

Wartość zwracana

Ten element nie zwraca wartości

Zachowanie

Wymaga PDF 2.0 (ISO 32000-2) i stosuje się do zachowania StrictVersionLock, ponieważ /SD to wpis akcji wprowadzony w PDF 2.0
Emituje akcję GoTo z /D w tym samym kształcie [page /XYZ null y null] co AddGoToLink plus jednoelementową tablicę /SD przechowującą pośrednią referencję do StructElem
nil jako StructElem lub FallbackPageIndex poza zakresem powoduje wyjątek, zanim cokolwiek — adnotacja czy podbicie wersji — zostanie zapisane
Przy PDFUACompliance pusty Description powoduje wyjątek zgodnie z PDF/UA-1 §7.18.5

THPDFPage.AddStructureDestinationLink Method

Deklaracja

Jednostka

Parametry

Wartość zwracana

Zachowanie

Powiązane API