---

O Calc Workspace (área de trabalho Calc) oferece um ambiente de script baseado em eventos que pode ser usado para executar cálculos e dinamicamente controlar aspectos visuais do layout do relatório, enquanto o relatório está gerando. Scripts que respondem a eventos são chamados de manipuladores de eventos.

O Report Designer é dividido em quatro áreas principais, como mostrado no diagrama abaixo. Cada uma dessas áreas é abordada em detalhes nas páginas seguintes.

A - Code Explorer: Usado para organizar e gerenciar a caixa de ferramentas: Repositório de código Visual, os scripts de um relatório;

B - Editor de código: Usado para editar scripts;

C - The Code Toolbox: Repositório de código Visual, suporta drag-and-drop (arrastar e soltar) criação de scripts;

D - Janela de mensagens: Mensagens do compilador de scripts que verifica o seu código.

Code Explorer

O Code Explorer está contido nos painéis superiores esquerdo e direito do Calc workspace.

O painel esquerdo contém uma tree view - use-o para navegar no código do relatório. O painel direito contém uma list view - ele irá mostrar uma variedade de itens, dependendo do que for selecionado na tree view. Clicando com o botão direito na “árvore” você pode exibir um menu de contexto que permite controlar o comportamento do Code Explorer.

Visualizações

A guia Calc permite que você gerencie o report code utilizando três pontos de vista diferentes. Ao selecionar o menu View ou clicando com o botão direito sobre o espaço em branco do painel esquerdo:

• Variáveis;
• Eventos;
• Módulo.

A série de capturas de tela abaixo ilustram a forma como o relatório pode ser exibido.

Você pode selecionar um modo de exibição usando o menu View ou posicionando o mouse sobre o espaço em branco do painel esquerdo e pressionando o botão direito do mouse para exibir um menu de contexto.

Variáveis da visualização

Esta visão permite que você veja as variáveis dentro de um relatório. Variáveis permitem executar cálculos. Observe que apenas as bandas são exibidas no painel esquerdo. O único componente visível a partir deste ponto de visão é a variável. Todos os outros componentes do relatório estão escondidos nesta visão.

Eventos da Visão

Esta visão mostra uma tree view com todos os componentes contidos no relatório. O painel direito exibe eventos associados com o componente selecionado. Seleção de um evento irá mostrar o script do evento, se houver.

Módulo View

Esta visão mostra uma visão global de todo o módulo calc. Ele lista as declarações, eventos, programas e manipuladores de eventos. Esta visão é útil quando você deseja examinar todo o código do relatório.

Este ponto de vista exibe itens, que são visíveis para todos os manipuladores de eventos do relatório:

Declarations - Estas variáveis e constantes são globalmente visíveis ao longo do relatório;

Events - Estes são, em essência, os eventos do relatório. No caso em que a janela de pré-visualização é exibida, os eventos OnCreate e OnDestroy são executados quando a janela é aberta e fechada, respectivamente. Os eventos BeforePrint e AfterPrint são métodos disparados a cada impressão, antes e depois da mesma, respectivamente. Os eventos OnCreate e OnDestroy são bons lugares para a inicialização e finalização de código, como a criação e liberando objetos e inicialização de variáveis;

Programs - Estes são procedimentos e funções que são globalmente visíveis em todo o relatório e podem, portanto, serem chamados de qualquer manipulador de eventos;

Event Handlers - Estes são todos os manipuladores de eventos que têm sido implementados no relatório.

Code Toolbox

O Code Toolbox é um repositório de código visual. Ele contém a maioria dos identificadores e elementos de código que o compilador RAP reconhece.

Note que o Code Toolbox tem três abas: Dados, objetos, e Idioma. Cada guia é composta de um treeview e uma lista de identificadores.

Guia de dados

A guia de dados do Code Toolbox exibe pipelines de dados e campos, o que lhe permite arrastar e soltar referências de campo no editor de código.

A seleção de um pipeline a partir da lista irá exibir todos os campos do mesmo, bem como: tipo e tamanho de dados de informações para os campos.

Para inserir um valor de campo para a janela de edição do código, selecione o campo e arraste-o para o editor de código. O código necessário para recuperar o valor do campo a partir do pipeline será gerado. Por exemplo: arrastando o campo 'City' do Code Toolbox resultaria neste código abaixo:

Value := Clients['City']

Guia de Objetos

A guia de Objetos do Code Toolbox exibe objetos de relatório e as suas propriedades, o que lhe permite arrastar e soltar propriedades no Editor de Código.

A seleção de um objeto a partir da árvore irá exibir uma lista de propriedades do objeto.

Para inserir uma propriedade no editor de código, selecione a propriedade e arraste-a para o editor de código. O código necessário para recuperar o valor da propriedade ou chamar o método será gerado. Por exemplo, arrastando a propriedade 'AutoSize' do Code Toolbox resultaria no código abaixo:

Label1.AutoSize

Guia de idiomas

A guia de Idiomas do Code Toolbox exibe elementos de linguagem RAP, o que lhe permite arrastar e soltar elementos no Editor de código.

Seleção de uma categoria a partir de uma “árvore” que irá exibir uma lista de elementos para essa categoria.

Para inserir um elemento no editor de código, selecione o elemento e arraste-o para o editor de código. O código necessário para fazer referência ou o elemento irá ser gerado. Note que quando você arrasta um item, como uma chamada de função, a lista de parâmetros da função é fornecida. Por exemplo, se você arrastar Copy para o editor de código, ele irá se expandir como:

Copy(S, Index, Count);

Editor de código

O código aparece no editor de código quando você seleciona um evento na list view do Code Explorer ou clica com o botão direito e seleciona New. Você pode criar um código, arrastando e soltando-o do Code Toolbox, ou você pode escrever seu próprio código. Quando for compilar o código, basta clicar com o botão direito sobre o espaço em branco do editor de código e selecione 'Compile'. Na janela abaixo o editor de código vai indicar se houve ou não algum erro no seu código.

O menu do editor de código contém os seguintes itens:

New

New tem o mesmo efeito que clicar no Editor de código. Ele só é ativado se não houver uma implementação para o item selecionado no Código Explorer.

Compile

Compile ativa o compilador RAP para tentar compilar o procedimento atual e quaisquer procedimentos sobre os quais o atual dependa.

Save

O Calc workspace mantém um buffer intermediário para o editor de código. Selecionando Save vai enviar o conteúdo atual do editor de código para o buffer; ele não vai salvar todo o relatório. Selecionar Save tem o mesmo efeito que navegar, e, em seguida, retornar para a procedure atual.

Revert

Use Revert para substituir o conteúdo do editor de código com o código que está atualmente contido no buffer. Isso tem o efeito de remover todas as alterações desde a última gravação.

Delete

Selecione Delete para excluir o atual procedimento.

Message Window

As mensagens do compilador são exibidas aqui. Você pode navegar para a localização do erro do compilador com um duplo clique na mensagem de erro.