Formatação de Valores em Edit e Display

Esta página apresenta como preencher o campo Formato disponível nos objetos do tipo Edit e Display.

Nota

Atenção! Esta página contém explicações sobre dois tipos de formatos: antigo e novo (compatível versão >= 1.0.04). Recomenda-se a utilização do formato novo pois o formato antigo pode não ser suportado em futuras versões.

Formatação

Esta formatação é valida a partir da versão 1.0.04 do HIscada Pro.

A formatação de dados dos componentes de tela devem ser utilizados para especificar o formato de apresentação dos valores. As opções de formatação são apresentadas na tabela abaixo.

Caracteres de Formatação
Símbolo	Descrição do formato de apresentação do valor	Exemplo
%d	Valor inteiro decimal com sinal	%d
%u	Valor inteiro decimal sem sinal	%u
%x ou %X	Valor em hexadecimal, %x apresenta em minuscula, e %X apresenta em maiuscula.	%X
%f	Valor em ponto flutuante	%f, %.2f, %5.3f
%c	Caracter unico	%c
%s	Texto com multiplos caracteres	%s
%e	Valor numérico em notação cientifica	%e
%o	Valor em octal	%o

Observações:

• Os valores em ponto flutuante são arredondados na sua apresentação. Por exemplo: o valor numérico 12.456 é apresentado como 12.46 com formatação para duas casas decimais, e apresentado como 12.5 com formatação para apenas uma casa decimal

• Pode-se utilizar textos adicionais a formatação para complementar a apresentação do valor corrente. Neste caso os textos adicionais são reproduzidos sem alteração na apresentação do valor numérico. Este recurso é util, por exemplo, para apresentação da unidade de engenharia associada ao valor numérico

Exemplos:

• %04d: apresentação de valor em decimal com pelo menos 4 digitos. Se o valor numérico não possuir 4 digitos, será preenchido com digitos “0” a esquerda. Se possuir mais de 4 digitos, é apresentado o valor numérico completo.

• %1.2f: apresentação de valor em ponto flutuante com 1 digito para a parte inteira e dois digitos para a parte fracionária, ou seja duas casas decimais. Se a parte inteira possuir mais de um digito é aprsentado o valor numérico completo.

• %.1f: apresentação de valor em ponto flutuante com apenas uma casa decimal

• %.2f: apresentação de valor em ponto flutuante com duas casas decimais

• %.0f: apresentação de valor em ponto flutuante com supressão das casas decimais

Formatação	Valor corrente	Valor apresentado	Comentário
%d	12	12	valor inteiro
%04d	12	0012	valor inteiro com pelo menos 4 digitos
%1.2f	1234.567	1234.57	valor ponto flutuante com duas casas decimais
%.2f	123.4567	123.46	valor ponto flutuante com duas casas decimais
%.0f	12.34567	12	valor ponto flutuante com supressão de casas decimais
%.1f psi	100.2345	100.2 psi	Acréscimo de texto “psi” a formatação
T: %.2f oC	100.2345	T: 100.23 oC	Acréscimo de textos “T:” e “oC” a formatação
%.2f %	10.2345	10.23 %	Acréscimo de texto “%” a formatação
%x	12	c	valor hexadecimal minusculo
%02X	12	0C	valor hexadecimal maiusculo com pelo menos 2 digitos

Formatação (padrão antigo)

Esta formatação é valida até a versão 1.0.03. Para versões superiores recomenda-se utilizar o novo padrão de formatação apresentado no item anterior, pois a compatibilidade com este padrão antigo não é garantida.

A formatação de dados dos componentes de tela devem ser utilizados para especificar o formato de apresentação dos valores. As opções de formatação são apresentadas na tabela abaixo.

Quando o campo de dados permite a edição de valores este pode ser formatado utilizando uma mascara de edição. Esta máscara é separada em três campos, separados pelo caracter ‘;’. O primeiro campo é a máscara propriamente dita. O segundo campo indica se os literais da máscara serão salvos como parte dos dados ou não (se for 0). O terceiro campo é um caracter que irá substituir caracteres esperados pela máscara, mas não fornecidos.

Caracteres de Formatação e Mascaramento
Símbolo	Descrição
>	Próximos caracteres alfabéticos serão convertidos para maiúscula até o fim ou até um <.
!	Se o ! aparece na máscara, caracteres opcionais são representados por um cabeçalho de espaços em branco. Se o ! não estiver presente, os caracteres opcionais são representados por um sufixo de espaços em branco
	Se o par aparece na máscara os dados de entrada serão preservados sem conversão de maiúsculas/minúsculas.
\	Este caracter é usado para designar que caracteres de máscara devem ser interpretados como literais.
L,l	O caracter ‘L’ exige um caracter alfabético nesta posição. O caracter ‘l’ caracter torna opcional um caracter alfabético nesta posição.
0,9	Digito. Se a máscara é ‘9’, o digito é opcional, se é ‘0’ o digito é obrigatório.
A,a	Caracter alfanumérico na faixa de a-z ou A-Z ou 0-9. Se a máscara é ‘a’, o caracter é opcional, se for ‘A’ é obrigatório.
C,c	Caracter alfanuméricos imprimíveis, na faixa de 32 a 126. Se a máscara é ‘c’, o caracter é opcional, se for ‘C’ é obrigatório.
#	O caracter ‘#’ permite um caracter numérico, o sinal de + ou - nesta posição.
:	Separador de hora, minuto e segundo.
/	Separador de mês, dia, ano.
;	Separador dos 3 campos de uma máscara.
_	O caracter ‘_’ insere espaços em branco no texto da máscara. O cursor irá pular estes espaços no caso de campo de edição.

Todos caracteres ausentes da tabela acima, podem ser usados como literais no primeiro campo de uma máscara. Exemplo de máscara de telefone “(000)_0000-0000;0;”.

Exemplos de formatação de campo de dados:

• ##0: apresentação de valor em decimal com pelo menos 1 digito.

• #0.0: apresentação de valor em ponto flutuante com uma casa decmal

• #0.00: apresentação de valor em ponto flutuante com duas casas decmais