FUNDAMENTOPublicado
Pictures e máscaras em AdvPL
PICTURE "@E 999,999.99" · "@!" · "@A"Máscaras controlam apresentação, edição e formatação de valores em comandos visuais e relatórios.
Visão geral
Pictures são expressões de máscara usadas para formatar valores numéricos, datas, textos e campos exibidos em interfaces ou relatórios. A apostila introdutória cita símbolos como @A, @E e @!, que permanecem úteis para entender exemplos legados e comandos como SAY, GET e PSAY.
Sintaxe
PICTURE "@E 999,999.99" · "@!" · "@A"Valor numérico formatado
#Include "TOTVS.ch"
User Function ExPictureValor()
Local nTotal := 1520.75
MsgInfo(Transform(nTotal, "@E 999,999.99"), "Total")
ReturnResultado esperado
A máscara orienta a apresentação do número com casas decimais e separadores.
Texto em maiúsculas
#Include "TOTVS.ch"
User Function ExPictureTexto()
Local cNome := "cliente teste"
MsgInfo(Transform(cNome, "@!"), "Nome")
ReturnResultado esperado
A picture @! é usada para apresentar o conteúdo em maiúsculas.
- Use PICTURE compatível com o tipo do valor exibido ou editado.
- @E é comum para formatação numérica conforme máscara informada.
- @! força caracteres alfabéticos para maiúsculas em contextos de edição/formatação.
- @A restringe entrada/apresentação a letras em contextos compatíveis.
- Valide máscaras em telas traduzidas, pois tamanho e separadores podem variar.
- Uma máscara incompatível pode ocultar, truncar ou apresentar valor incorreto.
- Pictures antigas podem depender do comando ou componente usado; valide no SmartClient/release atual.
- Não trate máscara visual como validação de negócio completa.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.