THPDFPage.AddGoToRStructureDestinationLink Method
Adiciona uma anotação de link cuja ação GoToR tem como alvo um elemento de estrutura em um PDF externo pela string de bytes /ID desse elemento, mantendo o destino de página de fallback /D obrigatório no arquivo remoto
Declaração
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');Unidade
HPDFDoc
Parâmetros
| Nome | Finalidade |
|---|---|
Rectangle | Retângulo de área ativa em unidades de página onde o link é ativo |
FileName | Caminho não vazio para o PDF externo; barras invertidas são normalizadas para barras normais |
RemoteStructElemID | String de bytes /ID não vazia do StructElem de destino em FileName; deve corresponder ao /ID gravado nesse elemento por meio da sobrecarga IDStr de AddStructureElement |
FallbackTargetPageIndex | Índice de página baseado em zero obrigatório no arquivo remoto usado pelo destino de fallback /D; deve ser >= 0 |
YPos | Posição vertical opcional para o ajuste /XYZ; passe um valor negativo para deixá-la nula |
NewWindow | Quando verdadeiro, emite /NewWindow true para que o visualizador abra o destino em uma nova janela |
Description | Descrição alternativa armazenada no /Contents da anotação; obrigatória sob PDFUACompliance |
Valor de retorno
Este membro não retorna um valor
Comportamento
- Requer PDF 2.0 (ISO 32000-2) e segue o comportamento de
StrictVersionLock - Destinos de estrutura remotos não podem referenciar um StructElem estrangeiro por ponteiro, portanto a ISO 32000-2 §12.3.2.3 exige que o primeiro elemento
/SDseja a string de bytes/IDdo elemento de destino; a forma de string literal emitida corresponde à forma/IDqueAddStructureElementproduz para o mesmoIDStr - Emite uma ação GoToR com
/F, um destino de fallback/Dobrigatório e a matriz de strings de bytes/SD - Um
FileNamevazio, umRemoteStructElemIDvazio ou umFallbackTargetPageIndexnegativo lançam uma exceção antes de qualquer anotação ou incremento de versão ser emitido