Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

AXVISUAL()

AxVisual( <cAlias>, <nReg>, <nOpc>, [aAcho], [nColMens], [cMensagem], [cFunc], [aButtons], [lMaximized] )

Configura visualización de registros en interfaz legada.

AXVISUAL()AdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

AxVisual presenta interfaz de visualización según diccionario Protheus. Alias registrado en SX2, campos y validaciones en SX3; llamador proporciona registro y contexto browse. nOpc es posición de opción en aRotina, distinta del código de operación de cuarta columna: 2 en este ejemplo. Argumentos opcionales difieren entre funciones Ax; no trasladar posiciones de AxAltera a AxInclui ni AxDeleta. Ficha no formaliza retorno. Fragmento solo configura opción de rutina legada preparada, sin ejecutarla. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

AxVisual( <cAlias>, <nReg>, <nOpc>, [aAcho], [nColMens], [cMensagem], [cFunc], [aButtons], [lMaximized] )

Parámetros

cAlias
CarácterObligatorio

Alias registrado en SX2 y disponible en contexto.

nReg
NuméricoObligatorio

RecNo del registro en contexto browse.

nOpc
NuméricoObligatorio

Posición de opción en aRotina, no código universal de operación.

aAcho
ArrayOpcional

Campos mostrados; NOUSER puede impedir agregar campos de usuario.

nColMens
NuméricoOpcional

No utilizado en la ficha.

cMensagem
CarácterOpcional

No utilizado en la ficha.

cFunc
CarácterOpcional

Función para cargar variables de memoria.

aButtons
ArrayOpcional

Botones adicionales: bitmap, bloque y título.

lMaximized
LógicoOpcional

Maximización del diálogo.

Retorno

La ficha consultada no especifica contrato de retorno; el ejemplo no lo usa.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

// Fragmento: aRotina ya existe en llamador legado.
// Framework proporciona alias, registro y posicion de opcion.
AAdd(aRotina, {"Visualización", "AxVisual", 0, 2})
Resultado esperado

Agrega entrada de menú; no abre pantalla ni modifica datos por sí sola. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Probar en tabla propia con permisos y validación. Funciones genéricas no sustituyen reglas completas de negocio ni diseño MVC.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. AXVISUAL(). TDN. Contrato da função e exemplo aRotina. Consulta el 2026-10-26.
Estado
En revisión
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