Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

AXVISUAL()

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

Configura visualização de registros em interface legada.

AXVISUAL()AdvPL
01 · VISÃO GERAL

Visão geral

AxVisual apresenta a interface de visualização de registros segundo o dicionário Protheus. O alias deve estar registrado no SX2, com campos e validações no SX3; o chamador fornece o contexto do registro e do browse. nOpc é a posição da opção em aRotina. Não confundir essa posição com o código de operação guardado na quarta coluna do menu: 2 neste exemplo. As listas opcionais diferem entre as funções Ax; não reutilize posições de AxAltera em AxInclui ou AxDeleta. A ficha não formaliza retorno. O fragmento apenas configura uma opção em uma rotina legada já preparada, sem executar a operação. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

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

Parâmetros

cAlias
CaractereObrigatório

Alias registrado no SX2 e disponível no contexto.

nReg
NuméricoObrigatório

RecNo do registro no contexto do browse.

nOpc
NuméricoObrigatório

Posição da opção em aRotina, não código universal da operação.

aAcho
ArrayOpcional

Campos exibidos; NOUSER pode impedir a inclusão de campos do usuário.

nColMens
NuméricoOpcional

Não utilizado na ficha.

cMensagem
CaractereOpcional

Não utilizado na ficha.

cFunc
CaractereOpcional

Função para carregar variáveis de memória.

aButtons
ArrayOpcional

Botões adicionais: bitmap, bloco e título.

lMaximized
LógicoOpcional

Maximização do diálogo.

Retorno

A ficha consultada não especifica um contrato de retorno; o exemplo não o utiliza.

03 · EXEMPLO PRÁTICO

Exemplo comentado

// Fragmento: aRotina ja existe no chamador legado.
// O framework fornece alias, registro e posicao da opcao.
AAdd(aRotina, {"Visualização", "AxVisual", 0, 2})
Resultado esperado

Adiciona uma entrada de menu; não abre a tela nem altera dados isoladamente. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Homologar em tabela própria de teste, com permissões e validações. Funções genéricas não substituem regras completas de rotinas de negócio ou um projeto MVC.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. AXVISUAL(). TDN. Contrato da função e exemplo aRotina. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha