THPDFPage.AddStructureDestinationLink Method
Añade una anotación de enlace cuya acción GoTo lleva el destino alternativo /D obligatorio con coordenadas de página y el array /SD de PDF 2.0 que nombra el StructElem de destino mediante referencia indirecta, de modo que los visores PDF 2.0 saltan al contenido estructurado y los visores antiguos recurren a la página indicada
Declaration
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
Rectangle | Rectángulo de zona activa, en unidades de página, donde el enlace está activo |
StructElem | Diccionario StructElem indirecto no nil que sirve de destino, normalmente obtenido de AddStructureElement o FindStructureElementForMCID |
FallbackPageIndex | Índice de página obligatorio que usa el destino explícito /D para los visores que no son PDF 2.0 |
YPos | Posición vertical opcional para el ajuste /XYZ; pase un valor negativo para dejarla en null |
Description | Descripción alternativa que se guarda en /Contents de la anotación; obligatoria con PDFUACompliance |
Return value
Este miembro no devuelve ningún valor
Behavior
- Requiere PDF 2.0 (ISO 32000-2) y sigue el comportamiento de
StrictVersionLock, ya que/SDes una entrada de acción de PDF 2.0 - Emite una acción GoTo con
/Dcon la misma forma[page /XYZ null y null]queAddGoToLink, más un array/SDde un solo elemento con la referencia indirecta al StructElem - Un StructElem
nilo unFallbackPageIndexfuera de rango lanzan una excepción antes de que se emita ninguna anotación o se incremente la versión - Under
PDFUACompliancean emptyDescriptionraises per PDF/UA-1 §7.18.5