FUNDAMENTOPublicado
User Function
User Function <Nome>()Declara una función pública que puede ser llamada por el entorno, menús, puntos de entrada u otras rutinas AdvPL.
Descripción general
User Function es la forma tradicional de declarar una rutina AdvPL accesible externamente. El nombre informado identifica una función que puede ejecutarse desde menús, llamadas directas, puntos de entrada u otros mecanismos del entorno. En materiales didácticos antiguos aparece como la primera estructura para crear una rutina ejecutable.
Sintaxis
User Function <Nome>()Rutina pública simple
#Include "TOTVS.ch"
User Function CursoADVPL()
Local cMensagem := "Primeira rotina AdvPL"
MsgInfo(cMensagem, "Treinamento")
ReturnResultado esperado
La función U_CursoADVPL puede ser llamada por el entorno u otro fuente según la convención utilizada.
User Function llamando una función auxiliar
#Include "TOTVS.ch"
User Function ExRelatorio()
Local cTitulo := "Relatório introdutório"
U_MostraTitulo(cTitulo)
Return
Static Function MostraTitulo(cTitulo)
MsgInfo(cTitulo, "Título")
ReturnResultado esperado
La User Function queda como punto de entrada y la regla auxiliar permanece encapsulada en el mismo fuente.
- Use nomes claros, curtos e estáveis para rotinas chamadas externamente.
- Declare variáveis locais logo no início do bloco para reduzir criação implícita de Private.
- Mantenha o retorno compatível com o contrato esperado por quem chama a função.
- Evite misturar muitas responsabilidades em uma única User Function; extraia regras para funções auxiliares.
- Renombrar una User Function usada en menús, puntos de entrada o llamadas externas rompe la referencia.
- Demasiadas funciones públicas dificultan la gobernanza y el mantenimiento.
- Los ejemplos históricos usan RWMake.ch; para nuevos fuentes, evalúa TOTVS.ch según la orientación actual del entorno.
Comentarios
Todavía no hay comentarios aprobados.
Inicia sesión con Google o Microsoft para comentar.