- Criado por Carlos Philippe de Farias Marques, última alteração por Jefferson Duarte Rodrigues em 17 out, 2022
Índice:
Como Funciona:
Como exemplo usaremos o Relatório TesteFormatação . Existem 3 campos nesse relatório:
- CHAPA
- NOME
- SALÁRIO
Iremos utilizar o campo SALÁRIO como base para a explicação sobre a formatação. Observe a imagem abaixo e perceba que o campo SALÁRIO está sem formatação.
Imagem 1 - Relatório TesteFormatação com campo SALÁRIO sem formatação.
Configurando a Formatação
Clicando na SmartTag do controle a ser formatado a tela "Texto Tarefas" será apresentada.
Imagem 2 - Tela "Texto Tarefas".
Clicando em [...] na Propriedade Formato do Texto a Tela "Editor de Formatar Caracter" será apresentada.
Imagem 3 - Tela "Editor de Formatar Caracter".
Diferentes Categorias de Formatação
Formata diferentes valores transformando-os em data (System.DateTime). |
Formata diferentes valores transformando-os em numéricos. |
Ao utilizar uma máscara numérica contendo com '#' significa que o dígito é opcional, o que irá representar um vazio quando não houver valores. Para tornar a representação do dígito obrigatória basta utilizar o carácter '0'. Com isso, a posição do dígito sempre será informada.
Abaixo seguem alguns exemplos para simplificar o entendimento.
Exemplos:
O número *012* com uma das máscaras ('#', '##', '###', '####', '#0', '#00', ... ) resultará em *12* (perceba que não é obrigatório exibir o número insignificante '0')
Os números *012* ou mesmo o número *12* com máscara '000' resultará em *012* (perceba que mesmo o número insignificante '0' será exibido pois essa máscara obriga a exibição de 3 dígitos)
Formata os valores numéricos transformando-os em valores percentuais. |
Formata os valores numéricos transformando-os em valores monetários (acompanhados ou não, dos símbolos monetários). |
Tipos especiais de Formatação, como telefone, cpf, cnpj, entre outros. |
Utiliza prefixos e sufixos para gerar a máscara de formatação à ser utilizada.
Links Auxiliares
Links que podem auxiliar no entendimento da funcionalidade:
Aplicando a Formatação
Ao escolher o tipo de Formatação, por exemplo, Formato Monetário {0:c2}, ao gerar o relatório o mesmo será devidamente aplicado.
Imagem 10 - Escolhendo o formato que será aplicado no controle.
Imagem 11 - Relatório TesteFormatação com campo SALÁRIO devidamente formatado.
Restrições da Funcionalidade e Usos Inadequados
- Não existe implementação, hoje, no Reports que possibilite, a formatação de vários controles ao mesmo tempo.
- Existe uma funcionalidade chamada SUMÁRIO, disponibilizada ao escolher mais de um controle, onde uma de suas propriedades também é "Formato de texto", porém ela é utilizada internamente nos cálculos à ser realizado pelo SUMÁRIO, ela não tem ligação direta com a propriedade de mesmo nome disponibilizada individualmente em cada controle, explicada acima, no passo a passo.
Imagem 12 - Propriedade "Formato do Texto" do Sumário.
- A formatação de texto deverá ocorrer individualmente para cada controle.
Produto: Framework
Versão: 12.01.XX
Processo: Formatação
Status: Finalizado
Data: 10/10/2017