Usina BRAdvPL Guia
Entrar
← Todos os tópicos
COMANDOEm revisão

@ ... BUTTON

@ nRow, nCol BUTTON oBtn CAPTION cCaption [SIZE nWidth, nHeight] [ACTION uAction] OF oWnd

Cria um botão e associa a ação ao clique.

@ ... BUTTONAdvPL
01 · VISÃO GERAL

Visão geral

O Guia de referência eAdvpl, §3.10, p. 14, registra a variante histórica apresentada na sintaxe. Os fragmentos pressupõem o ambiente e as definições de comandos correspondentes; não são um aplicativo completo. Na variante histórica, CAPTION informa o rótulo e OF identifica a janela. No AdvPL documentado com TButton também há construção por New/Create; exemplos de outros includes podem utilizar PROMPT. Não misturar as palavras-chave de variantes diferentes. Um clique deve executar a ação no momento do evento: evitar chamadas antecipadas durante a montagem da tela. (Refs. 1–2)

02 · SINTAXE

Sintaxe

@ nRow, nCol BUTTON oBtn CAPTION cCaption [SIZE nWidth, nHeight] [ACTION uAction] OF oWnd

Parâmetros

nRow, nCol
NuméricoObrigatório

Posição de origem na unidade da variante utilizada.

oWnd / oDlg
ObjetoObrigatório

Janela pai existente; o nome deve corresponder ao código real.

cCaption
CaractereObrigatório

Rótulo visível no botão.

Retorno

Comando de interface/impressão; não usar como expressão com retorno de função.

03 · EXEMPLO PRÁTICO

Exemplo comentado

// Fragmento eAdvpl historico: oDlg ja deve existir.
Local oBtn
@ 2, 2 BUTTON oBtn CAPTION "Conferir" ;
    SIZE 12, 1 ACTION Alert("Acao solicitada") OF oDlg
Resultado esperado

Propõe um botão que exibe uma mensagem ao clicar, sem gravar dados. Homologar a expansão ACTION do include utilizado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Validar entradas e autorização dentro da ação. Impedir cliques duplicados em tarefas que gravam dados; desabilitar o botão não substitui validação no servidor.
  • 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. Guia de referência eAdvpl. §3.10, p. 14. Cópia pública histórica; autoria e compatibilidade atual não confirmadas. Consulta em 2026-10-24.
  2. TOTVS. Classe TButton. TOTVSTEC/TDN. Consulta em 2026-10-24.
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