THPDFPage.AddStructureDestinationLink Method
Lägger till en länkanteckning vars GoTo-åtgärd bär den obligatoriska sidkoordinatbaserade /D-fallbackdestinationen och PDF 2.0-/SD-arrayen som namnger mål-StructElem via indirekt referens, så att PDF 2.0-visare hoppar till strukturinnehållet medan äldre visare faller tillbaka till den namngivna sidan
Deklaration
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Enhet
HPDFDoc
Parametrar
| Name | Purpose |
|---|---|
Rectangle | Klickruta i sidenheter där länken är aktiv |
StructElem | Icke-nil indirekt StructElem-ordbok att rikta in sig på, vanligtvis från AddStructureElement eller FindStructureElementForMCID |
FallbackPageIndex | Obligatoriskt sidindex som används av den explicita /D-destinationen för icke-PDF-2.0-visare |
YPos | Valfri vertikal position för /XYZ-passningen; skicka ett negativt värde för att lämna det null |
Description | Alternativ beskrivning som lagras i anteckningens /Contents; obligatorisk under PDFUACompliance |
Returvärde
Denna medlem returnerar inget värde
Beteende
- Kräver PDF 2.0 (ISO 32000-2) och följer
StrictVersionLock-beteendet, eftersom/SDär en PDF 2.0-åtgärdspost - Sänder en GoTo-åtgärd med
/Di samma[page /XYZ null y null]-form somAddGoToLinkplus en ett-element-/SD-array som håller den indirekta StructElem-referensen - En
nil-StructElem eller ett sidindex utanför intervallet iFallbackPageIndexhöjer ett undantag innan någon anteckning eller versionshöjning sänds - Under
PDFUACompliancehöjer en tomDescriptionett undantag enligt PDF/UA-1 §7.18.5