Anchors

Uma âncora é um dos elementos no sistema de hiperlinks que permite saltar para qualquer elemento conectado ao objeto do relatório concluído ao clicar nele (na janela de visualização).

A âncora pode ser configurada através do método "Engine.AddAnchor". Uma âncora possui um nome e uma posição na página de um relatório. Para saltar para uma âncora com um nome especificado, digite a seguinte linha na propriedade URL de qualquer objeto do relatório:

#AnchorName

ou

#[AnchorName]

No segundo caso o FastReport substitui um valor pela expressão.

Ao clicar no objeto, um salto é executado para o local do relatório onde foi adicionada a âncora.

Use âncoras ao construir uma tabela de "Conteúdo", por exemplo com links para capítulos correspondentes. Vamos ilustrar isso no exemplo a seguir. Primeiro precisamos da familiar tabela "Clientes".

Nosso relatório terá diversas páginas (com duas páginas de design). Colocaremos a tabela de "Conteúdo" na primeira página e a lista de clientes na segunda página. Um clique em qualquer linha de Conteúdo executa um salto até o elemento correspondente do relatório.

A primeira página de design:

Coloque o seguinte texto na propriedade URL do objeto "Texto" contido na banda de dados

#[Customers."Company"]

e configure as propriedades da fonte como azul e sublinhado para simular o aspecto de um hiperlink.

A segunda página de design:

Para adicionar uma âncora, crie um manipulador de eventos "MasterData2.OnBeforePrint" no script:

PascalScript:

procedure MasterData2OnBeforePrint(Sender: TfrxComponent);
begin
  Engine.AddAnchor(<Customers."Company">);
end;

C++ Script:

void MasterData2OnBeforePrint(TfrxComponent Sender)
{
  Engine.AddAnchor(<Customers."Company">);
}

Isso é tudo que é necessário. Visualize o relatório e certifique-se de que todos os "hiperlinks" estejam funcionando.

O último item a ser mencionado é a função Engine.GetAnchorPage. Esta função retorna o número da página à qual foi adicionada a âncora correspondente, e é util ao criar a tabela "Conteúdo". O relatório deve ter dois passos ou a função não pode ser utilizada.