Produto:

TOTVS Reports

Ocorrência:

Passo a passo

1 - Expressão (Entendendo as Propriedades)

O componente expressão tem várias propriedades, e o entendimento das mesmas é necessário para uma correta configuração do componente.

1.1 - Propriedades Presentes na Smart Tag

Ao adicionar um componente Expressão, o usuário observará uma pequena seta do lado direito superior do componente. A clicar na seta, uma pequena janela será mostrada com algumas propriedades, essas propriedades são muito importantes para a correta configuração do componente.

Essas propriedades são:

1.1.1 - Propriedade Expressão

Ao clicar no botão [...] do lado direito da caixa de texto, vinculados a propriedade Expressão, uma tela será apresentada:
 

Nela temos duas funcionalidades:

1.1.2 - Funcionalidade Funções

As funções disponíveis são:

N°	Nome	Descrição
1	Lógico	Comandos lógicos; Apresentação de resultado conforme condições. Funções Disponíveis: N° Nome Parâmetros Descrição 1 If N° Parâmetro Tipos possíveis 1 Teste Boolean 2 Verdadeiro DateTime Decimal Enum Integer Object String 3 Falso DateTime Decimal Enum Integer Object String Promove resultado condicional, ou seja, pode ser apresentado um re- sultado definido como verdadeiro, ou pode ser apresentado um resul- tado definido como falso.
2	Conversão	Comandos de conversão; Realiza a conversão de tipos; Necessário para o bom funcionamento caso se utilize como parâmetro de outras funções. Funções Disponíveis: N° Nome Parâmetros Descrição 1 Boolean N° Parâmetro Tipos possíveis 1 Valor Boolean DateTime Decimal Enum Integer Object String Converte um objeto em um valor lógico. 2 DateTime N° Parâmetro Tipos possíveis 1 Valor Boolean DateTime Decimal Enum Integer Object String Converte um objeto em um valor Data/Hora. 3 Decimal N° Parâmetro Tipos possíveis 1 Valor Boolean DateTime Decimal Enum Integer Object String Converte um objeto em um valor numérico decimal (fracionário ou não). 4 Enum N° Parâmetro Tipos possíveis 1 Valor Boolean DateTime Decimal Enum Integer Object String Converte um objeto em um valor Enumerado . 5 Integer N° Parâmetro Tipos possíveis 1 Valor Boolean DateTime Decimal Enum Integer Object String Converte um objeto em um valor inteiro.  6 Object N° Parâmetro Tipos possíveis 1 Valor Boolean DateTime Decimal Enum Integer Object String Converte qualquer outro tipo em um objeto.  7 String N° Parâmetro Tipos possíveis 1 Valor Boolean DateTime Decimal Enum Integer Object String Converte um objeto em um valor alfanumérico .
3	Matemática	Comandos matemáticos; Permite arredondamentos, truncamentos, calculo com ângulos, etc...  Funções Disponíveis: Nº Nome Parâmetro Descrição 1 Trunc N° Parâmetro Tipos possíveis 1 Valor Decimal Retorna o numero informado trun- cado, ou seja, retorna a parte in- teira de um numero, a parte fra- cionária é descartada.  2 Round N° Parâmetro Tipos possíveis 1 Valor Decimal Retorna o valor informado arre- dondado. 3 ArcTan N° Parâmetro Tipos possíveis 1 Tangente Decimal Retorna o valor do ângulo para o valor da tangente informado. 4 Cos N° Parâmetro Tipos possíveis 1 Ângulo Decimal Retorna o coseno do ângulo infor- mado. 5 Exp N° Parâmetro Tipos possíveis 1 Potência Decimal Retorna o valor de e elevado a po- tência informada. 6 Frac N° Parâmetro Tipos possíveis 1 Valor Decimal Retorna a parte fracionária de um numero informado. 7 Int N° Parâmetro Tipos possíveis 1 Valor Decimal Retorna a parte inteira de um nu- mero informado. 8 Log N° Parâmetro Tipos possíveis 1 Valor Decimal Retorna o logaritmo do número in- formado.  9 Sin N° Parâmetro Tipos possíveis 1 Ângulo Decimal Retorna o seno do ângulo informa- do. 10 Sqr N° Parâmetro Tipos possíveis 1 Valor Decimal Retorna o número informado eleva- do ao quadrado. 11 Sqrt N° Parâmetro Tipos possíveis 1 Valor Decimal Retorna a raiz quadrada do nume- ro informado 12 Abs N° Parâmetro Tipos possíveis 1 Valor Decimal Retorna o valor absoluto do núme- ro informado.  13 Power N° Parâmetro Tipos possíveis 1 Valor Decimal 2 Potência Decimal Retorna um valor elevado a potên- cia informada. 14 Random N° Parâmetro Tipos possíveis 1 Máximo Integer Retorna um valor aleatório.
4	Texto	Comandos de Texto; Permite transformar os caracteres de uma cadeia de caracteres em maiúsculo, minusculo; Permite remover os espaços em branco tanto na frente quanto atrás da cadeia de caracteres; Permite remover caracteres da cadeia de caracteres, etc... Funções Disponíveis: N° Nome Parâmetros Descrição 1 Upper N° Parâmetro Tipos possíveis 1 Texto String   2 Lower N° Parâmetro Tipos possíveis 1 Texto String   3 Length N° Parâmetro Tipos possíveis 1 Texto String   4 Trim N° Parâmetro Tipos possíveis 1 Texto String   5 TrimEnd N° Parâmetro Tipos possíveis 1 Texto String   6 TrimStart N° Parâmetro Tipos possíveis 1 Texto String   7 IndexOf N° Parâmetro Tipos possíveis 1 Texto1 String 2 Texto2 String 3 Posição Integer 4 Inicio Integer 5 Fim Integer   8 LastIndexOf N° Parâmetro Tipos possíveis 1 Texto1 String 2 Texto2 String   9 PadLeft N° Parâmetro Tipos possíveis         10 PadRight N° Parâmetro Tipos possíveis         11 Remove N° Parâmetro Tipos possíveis         12 SubString N° Parâmetro Tipos possíveis         13 Replace N° Parâmetro Tipos possíveis         14 ReplaceAll N° Parâmetro Tipos possíveis         15 StringBetween N° Parâmetro Tipos possíveis         16 Format N° Parâmetro Tipos possíveis         17 Split N° Parâmetro Tipos possíveis         18 Join N° Parâmetro Tipos possíveis
5	Data/Hora
6	Financeira
7	Estatística

1.1.2 - Funcionalidade Parâmetros

1.1.2 - Propriedades Formato e Arredondar Valor

• Para melhor compreender a propriedade Formato, veja Formatação (Passo a Passo).
• Para melhor compreender a propriedade Arredondar Valor, veja Propriedade Arredondar Valor.