THPDFPage.AddGoToRStructureDestinationLink Method
GoToR action'ı, bir external PDF'teki structure element'e o elementin byte-string /ID değeriyle hedeflenen bir link annotation ekler; zorunlu /D fallback page destination'ını remote dosyada tutar
Bildirim
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Birim
HPDFDoc
Parametreler
| Ad | Amaç |
|---|---|
Rectangle | Bağlantının etkin olduğu page unit cinsinden hot-spot dikdörtgeni |
FileName | External PDF'e boş olmayan yol; backslash'ler forward slash'a normalize edilir |
RemoteStructElemID | FileName içindeki hedef StructElem'in boş olmayan byte-string /ID değeri; AddStructureElement'in IDStr overload'u ile o elemente damgalanan /ID ile eşleşmelidir |
FallbackTargetPageIndex | /D fallback destination'ının kullandığı remote dosyadaki zorunlu sıfır tabanlı sayfa indeksi; >= 0 olmalıdır |
YPos | /XYZ fit için isteğe bağlı dikey konum; null bırakmak için negatif bir değer geçirin |
NewWindow | true olduğunda /NewWindow true yayar; böylece viewer hedefi yeni bir pencerede açar |
Description | Annotation /Contents içinde saklanan alternatif açıklama; PDFUACompliance altında zorunludur |
Dönüş değeri
Bu üye değer döndürmez
Davranış
- PDF 2.0 (ISO 32000-2) gerektirir ve
StrictVersionLockdavranışını izler - Remote structure hedefleri yabancı bir StructElem'e pointer ile başvuramaz; bu yüzden ISO 32000-2 §12.3.2.3, ilk
/SDelementinin hedef elementin byte-string/IDdeğeri olmasını zorunlu kılar; yayılan literal-string biçimi,AddStructureElement'in aynıIDStriçin ürettiği/IDbiçimiyle eşleşir /F, zorunlu bir/Dfallback destination'ı ve/SDbyte-string array'i ile bir GoToR action yayar- Boş bir
FileName, boş birRemoteStructElemIDveya negatif birFallbackTargetPageIndex; herhangi bir annotation veya version bump yayılmadan önce exception fırlatır