THPDFPage.AddStructureDestinationLink Method
Voegt een koppelingsannotatie toe waarvan de GoTo-actie de vereiste pagina-coördinaat-/D-fallback-bestemming en de PDF 2.0-/SD-array draagt die het doel-StructElem bij indirecte verwijzing noemt, zodat PDF 2.0-viewers naar structuurinhoud springen terwijl legacy-viewers terugvallen op de benoemde pagina
Declaratie
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Eenheid
HPDFDoc
Parameters
| Naam | Doel |
|---|---|
Rectangle | Hotspot-rechthoek in pagina-eenheden waar de koppeling actief is |
StructElem | Niet-nil indirect StructElem-woordenlijst als doel, doorgaans van AddStructureElement of FindStructureElementForMCID |
FallbackPageIndex | Vereiste pagina-index die door de /D-expliciete bestemming wordt gebruikt voor niet-PDF-2.0-viewers |
YPos | Optionele verticale positie voor de /XYZ-passing; geef een negatieve waarde door om deze null te laten |
Description | Alternatieve beschrijving die in de annotatie-/Contents wordt opgeslagen; vereist onder PDFUACompliance |
Retourwaarde
Dit lid retourneert geen waarde
Gedrag
- Vereist PDF 2.0 (ISO 32000-2) en volgt het
StrictVersionLock-gedrag, omdat/SDeen PDF 2.0-actievermeldingsveld is - Voert een GoTo-actie uit met
/Din dezelfde[page /XYZ null y null]-vorm alsAddGoToLinkplus een/SD-array met één element dat de indirecte StructElem-verwijzing bevat - Een
nil-StructElem of een buiten bereik vallendeFallbackPageIndexveroorzaakt een fout voordat er een annotatie of versieverhoging wordt uitgevoerd - Onder
PDFUAComplianceveroorzaakt een legeDescriptioneen fout volgens PDF/UA-1 §7.18.5