THPDFPage.AddGoToRStructureDestinationLink Method
Dodaje adnotację linku, której akcja GoToR wskazuje element struktury w zewnętrznym PDF po ciągu bajtów /ID tego elementu, zachowując jednocześnie wymagany zapasowy cel strony /D w pliku zdalnym
Deklaracja
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Jednostka
HPDFDoc
Parametry
| Nazwa | Przeznaczenie |
|---|---|
Rectangle | Prostokąt aktywnego obszaru linku w jednostkach strony |
FileName | Niepusta ścieżka do zewnętrznego PDF; ukośniki wsteczne są normalizowane do ukośników zwykłych |
RemoteStructElemID | Niepusty ciąg bajtów /ID docelowego StructElem w FileName; musi pasować do /ID wytłoczonego w tym elemencie przez wariant IDStr metody AddStructureElement |
FallbackTargetPageIndex | Wymagany indeks strony liczony od zera w pliku zdalnym, używany przez zapasowy cel /D; musi być >= 0 |
YPos | Opcjonalna pozycja pionowa dla dopasowania /XYZ; podaj wartość ujemną, aby pozostawić ją pustą |
NewWindow | Gdy true, emituje /NewWindow true, dzięki czemu czytnik otworzy cel w nowym oknie |
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 - Zdalnych celów struktury nie da się wskazać przez wskaźnik do obcego StructElem, więc ISO 32000-2 §12.3.2.3 wymaga, aby pierwszym elementem
/SDbył ciąg bajtów/IDelementu docelowego; emitowana forma literału łańcuchowego pasuje do formy/ID, jakąAddStructureElementprodukuje dla tego samegoIDStr - Emituje akcję GoToR z
/F, wymaganym zapasowym celem/Doraz tablicą/SDz ciągiem bajtów - Pusty
FileName, pustyRemoteStructElemIDlub ujemnyFallbackTargetPageIndexpowoduje wyjątek, zanim cokolwiek — adnotacja czy podbicie wersji — zostanie zapisane