THPDFPage.AddGoToRStructureDestinationLink Method
Añade una anotación de enlace cuya acción GoToR apunta a un elemento de estructura de un PDF externo mediante el /ID en cadena de bytes de ese elemento, y mantiene el destino alternativo obligatorio /D (página) en el archivo remoto
Declaration
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
Rectangle | Rectángulo de zona activa, en unidades de página, donde el enlace está activo |
FileName | Ruta no vacía al PDF externo; las barras invertidas se normalizan a barras normales |
RemoteStructElemID | /ID en cadena de bytes, no vacío, del StructElem de destino en FileName; debe coincidir con el /ID asignado a ese elemento mediante la sobrecarga IDStr de AddStructureElement |
FallbackTargetPageIndex | Índice de página obligatorio, base cero, del archivo remoto que usa el destino alternativo /D; debe ser >= 0 |
YPos | Posición vertical opcional para el ajuste /XYZ; pase un valor negativo para dejarla en null |
NewWindow | Si es true, emite /NewWindow true para que el visor abra el destino en una ventana nueva |
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
- Requires PDF 2.0 (ISO 32000-2) and follows
StrictVersionLockbehavior - Los destinos de estructura remotos no pueden referenciar un StructElem ajeno mediante un puntero, por lo que ISO 32000-2 §12.3.2.3 exige que el primer elemento de
/SDsea el/IDen cadena de bytes del elemento de destino; la forma de cadena literal emitida coincide con la forma de/IDque produceAddStructureElementpara el mismoIDStr - Emite una acción GoToR con
/F, un destino alternativo/Dobligatorio y el array de cadenas de bytes/SD - Un
FileNamevacío, unRemoteStructElemIDvacío o unFallbackTargetPageIndexnegativo lanzan una excepción antes de que se emita ninguna anotación o se incremente la versión