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

AXDELETA()

AxDeleta( <cAlias>, <nReg>, <nOpc>, [cTransact], [aCpos], [aButtons], [aParam], [aAuto], [lMaximized] )

Configura exclusão de registros em interface legada.

AXDELETA()AdvPL
01 · VISÃO GERAL

Visão geral

AxDeleta apresenta a interface de exclusã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: 5 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

AxDeleta( <cAlias>, <nReg>, <nOpc>, [cTransact], [aCpos], [aButtons], [aParam], [aAuto], [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.

cTransact
CaractereOpcional

Função chamada dentro da transação de AxFunction.

aCpos
ArrayOpcional

Campos de edição; em AxDeleta, campos exibidos.

aButtons
ArrayOpcional

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

aParam
ArrayOpcional

Funções antes da tela, validação, dentro e fora da transação, nessa ordem.

aAuto
ArrayOpcional

Campos, valores e validações do modo automático; requer análise própria.

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, {"Exclusão", "AxDeleta", 0, 5})
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. AXDELETA(). 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