THPDFPage.AddStructureDestinationLink Method
Adiciona uma anotação de link cuja ação GoTo carrega o destino de fallback /D obrigatório em coordenadas de página e a matriz /SD PDF 2.0 que nomeia o StructElem de destino por referência indireta, de modo que visualizadores PDF 2.0 saltem para o conteúdo de estrutura enquanto visualizadores legados recorrem à página nomeada
Declaração
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Unidade
HPDFDoc
Parâmetros
| Nome | Finalidade |
|---|---|
Rectangle | Retângulo de área ativa em unidades de página onde o link está ativo |
StructElem | Dicionário StructElem indireto não nulo a ser o alvo, normalmente de AddStructureElement ou FindStructureElementForMCID |
FallbackPageIndex | Índice de página obrigatório usado pelo destino explícito /D para visualizadores não PDF 2.0 |
YPos | Posição vertical opcional para o ajuste /XYZ; passe um valor negativo para deixá-la nula |
Description | Descrição alternativa armazenada em /Contents da anotação; obrigatória sob PDFUACompliance |
Valor de retorno
Este membro não retorna um valor
Comportamento
- Exige PDF 2.0 (ISO 32000-2) e segue o comportamento de
StrictVersionLock, pois/SDé uma entrada de ação PDF 2.0 - Emite uma ação GoTo com
/Dno mesmo formato[page /XYZ null y null]deAddGoToLinkmais uma matriz/SDde elemento único contendo a referência indireta ao StructElem - Um
nilStructElem ou umFallbackPageIndexfora do intervalo gera erro antes de qualquer anotação ou incremento de versão ser emitido - Sob
PDFUACompliance, umaDescriptionvazia gera erro conforme PDF/UA-1 §7.18.5