Método THPDFPage.AddGoToRStructureDestinationLink
Agrega una anotación de link cuya acción GoToR apunta a un structure element de un PDF externo por el /ID de byte-string de ese elemento, manteniendo el destino de página /D de fallback requerido en el archivo remoto
Declaración
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; 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 |
FileName | Ruta no vacía al PDF externo; las barras invertidas se normalizan a barras diagonales |
RemoteStructElemID | /ID de byte-string no vacío del StructElem objetivo en FileName; debe coincidir con el /ID estampado en ese elemento vía la sobrecarga IDStr de AddStructureElement |
FallbackTargetPageIndex | Índice de página requerido basado en cero en el archivo remoto que usa el destino de fallback /D; debe ser >= 0 |
YPos | Posición vertical opcional para el ajuste /XYZ; pasa un valor negativo para dejarlo nulo |
NewWindow | Cuando es true, emite /NewWindow true para que el viewer abra el objetivo en una ventana nueva |
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 - Los targets de estructura remota no pueden referenciar un StructElem ajeno por puntero, así que ISO 32000-2 §12.3.2.3 exige que el primer elemento de
/SDsea el/IDde byte-string del elemento objetivo; la forma de literal-string emitida coincide con la forma de/IDqueAddStructureElementproduce para el mismoIDStr - Emite una acción GoToR con
/F, un destino de fallback/Drequerido y el arreglo/SDde byte-string - Un
FileNamevacío, unRemoteStructElemIDvacío o unFallbackTargetPageIndexnegativo lanza una excepción antes de emitir cualquier anotación o bump de versión