Editor de Expressão

Grave uma expressão na janela Expressão

As expressões são baseadas no Microsoft® Visual Basic. O Editor de Expressão compreende um conjunto básico de funções do Visual Basic, assim como de todos os campos, funções, parâmetros do relatório ou variáveis de cálculo específicos do aplicativo. O Editor de Expressão tenta autocompletar os seus comandos conforme eles vão sendo digitados, e mostra as melhores correspondências em uma lista suspensa.

Para localizar o item necessário, execute uma das seguintes ações:

  • Digite a palavra completa

  • Digite uma correspondência parcial

  • Digite as letras maiúsculas ocorrentes (apenas letras latinas; não se aplica a fontes chinesas, japonesas ou russas)

Para inserir um item selecionado, pressione [Tab], [Enter] ou [Espaço].

Para fechar a lista sem inserir nada, posicione o cursor fora da palavra atual ou pressione [Esc].

Para abrir a lista novamente, continue digitando a expressão ou pressione [Ctrl]+[Espaço].

Para criar uma expressão dinâmica, o primeiro caractere da janela Expressão deve ser sempre um sinal de igual. Sem um sinal de igual, o sistema mostra o conteúdo como um simples texto estático no item de relatório.

Ao inserir expressões inválidas, uma linha vermelha pontilhada será exibida no Editor de Expressão. No entanto, ainda será possível salvar a expressão, pois ela pode conter códigos que não possuem o formato do Editor de Modelos de Relatório, mas que ainda são válidos no Visual Basic.

Quebrar a expressão em várias linhas

Para quebrar uma única expressão longa em várias linhas, escolha uma das seguintes abordagens:

  • Adicione um espaço seguido de um sublinhado (_) e, em seguida, adicione a quebra de linha.

    Em expressões usadas para cromatogramas, espectros, curvas de calibração ou gráficos, o sublinhado não funciona como um caractere de continuação de linha.

    Ou

  • Adicione a quebra de linha em uma posição válida, por exemplo, após um operador. Para obter uma lista de elementos de sintaxe que podem ser usados para continuar uma expressão em várias linhas, consulte https://docs.microsoft.com/en-us/dotnet/visual-basic/programming-guide/language-features/statements.

Destaque da sintaxe de expressões

Na caixa de texto do editor de expressões, a sintaxe da expressão introduzida é destacada em uma cor definida.

Estas cores são usadas para destacar diferentes tipos de sintaxe:

Cor

Tipo de sintaxe

Texto fixo que é colocada entre aspas.

Ações de fluxo do programa, tal como IF, Choose, etc.

Todas as outras funções suportadas.

Todos os operadores, como +, -, and, or, etc.

Todos os números constantes.

Todos os nomes de campo (campos VB.net, propriedades) listados na árvore Campos abaixo.

Verdadeiro, exibido para expressões válidas.

Falso, exibido para expressões inválidas.

Coloque o cursor na frente de um parêntese aberto ou depois de um parêntese fechado, respectivamente, e o parêntese correspondente fica destacado nesta cor.

Utilizar itens predefinidos

Categorias de itens

Categoria

Descrição

Globais

Contém diversas variáveis globais que são constantes em todo o relatório.

Parâmetros

Contém todos os parâmetros de relatório (consulte Parâmetros de relatório).

Campos

Contém todos os campos de dados disponíveis para o tipo de relatório do modelo atual.

Operadores

Contém uma coleção de vários operadores para combinar valores diferentes (consulte Operadores).

Funções Comuns

Contém uma coleção de várias funções que podem ser aplicadas aos campos de dados ou variáveis (consulte Funções).

Variáveis

Contém uma coleção de todas as variáveis que foram definidas nos itens de relatório anteriores (consulte Variáveis de Cálculo).

  • O painel inferior central exibe os itens específicos correspondentes à categoria selecionada. É possível inserir o item na sua expressão ao clicar duas vezes nele.

  • O painel Descrição mostra uma breve descrição do item selecionado. Ao selecionar a variável Agregador de Categoria, esse painel mostrará as funções que podem ser aplicadas à variável selecionada.

Salvar o resultado de uma expressão como variável

Clique em Salvar Resultado da Expressão como... para abrir uma caixa de diálogo em que é possível especificar um nome de variável. O resultado será armazenado com esse nome de variável e poderá ser acessado nos itens de relatório subsequentes.