Método THPDFPage.AddStructureDestinationLink
Agrega una anotación de link cuya acción GoTo lleva el destino de fallback /D de coordenadas de página requerido y el arreglo /SD de PDF 2.0 que nombra el StructElem objetivo por referencia indirecta, de modo que los viewers PDF 2.0 saltan al contenido de estructura mientras los viewers antiguos caen en la página indicada
Declaración
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Unidad
HPDFDoc
Parámetros
| Nombre | Propósito |
|---|---|
Rectangle | Rectángulo de hot-spot en unidades de página donde el link está activo |
StructElem | Diccionario StructElem indirecto no nil al que apuntar, típicamente de AddStructureElement o FindStructureElementForMCID |
FallbackPageIndex | Índice de página requerido que usa el destino explícito /D para viewers no PDF 2.0 |
YPos | Posición vertical opcional para el ajuste /XYZ; pasa un valor negativo para dejarlo nulo |
Description | Descripción alternativa almacenada en /Contents de la anotación; requerida bajo PDFUACompliance |
Valor de retorno
Este miembro no devuelve un valor
Comportamiento
- 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
/Den la misma forma[page /XYZ null y null]queAddGoToLinkmás un arreglo/SDde un solo elemento que contiene la referencia indirecta al StructElem - Un StructElem
nilo unFallbackPageIndexfuera de rango lanza una excepción antes de emitir cualquier anotación o bump de versión - Bajo
PDFUACompliance, unDescriptionvacío lanza una excepción según PDF/UA-1 §7.18.5