Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNDAMENTOPublicado

Pictures y máscaras en AdvPL

PICTURE "@E 999,999.99" · "@!" · "@A"

Las máscaras controlan presentación, edición y formato de valores en comandos visuales e informes.

PicturesMáscarasFormatoInterfazInformes
01 · DESCRIPCIÓN GENERAL

Descripción general

Pictures son expresiones de máscara utilizadas para formatear valores numéricos, fechas, textos y campos mostrados en interfaces o informes. La apostilla introductoria cita símbolos como @A, @E y @!, útiles para comprender ejemplos heredados y comandos como SAY, GET y PSAY.

02 · SINTAXIS

Sintaxis

PICTURE "@E 999,999.99" · "@!" · "@A"
03 · EJEMPLO PRÁCTICO

Valor numérico formateado

#Include "TOTVS.ch"

User Function ExPictureValor()
    Local nTotal := 1520.75

    MsgInfo(Transform(nTotal, "@E 999,999.99"), "Total")
Return
Resultado esperado

La máscara orienta la presentación del número con decimales y separadores.

04 · EJEMPLO PRÁCTICO

Texto en mayúsculas

#Include "TOTVS.ch"

User Function ExPictureTexto()
    Local cNome := "cliente teste"

    MsgInfo(Transform(cNome, "@!"), "Nome")
Return
Resultado esperado

La picture @! se usa para presentar el contenido en mayúsculas.

BUENAS PRÁCTICAS
  • 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.
ERRORES COMUNES
  • Una máscara incompatible puede ocultar, truncar o mostrar un valor incorrecto.
  • Pictures antiguas pueden depender del comando o componente usado; valida en el SmartClient/release actual.
  • No trates una máscara visual como validación completa de negocio.

Contenido relacionado

REFERENCIAS
  1. Apostila ADVPL Introd. Microsiga Campinas, 2001. Documentação oficial histórica de caráter didático e de suporte. Conteúdo histórico, resumido, revisado e adaptado para guia de referência.
  2. TOTVS. Pictures de formato y edición en AdvPL. TDN.
Estado
Publicado
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha