nLinha / nColunaNuméricoObrigatório
Posição do controle.
COMANDOEm revisão
BUTTON()
@ <nLinha>, <nColuna> BUTTON <cTexto> SIZE <nLargura>, <nAltura> PIXEL OF <oObjetoRef> ACTION <expressao>Documenta o comando visual @ ... BUTTON da ficha TOTVS.
Visão geral
Embora o título oficial seja BUTTON(), a sintaxe documentada é um comando iniciado por @, com posição, texto, tamanho, objeto pai e ação. Não se trata de uma função Button() isolada. A variante desta ficha usa BUTTON cTexto; a página histórica relacionada do site documenta uma variante com CAPTION e não deve ser misturada automaticamente. O exemplo cria um botão em diálogo e mantém a ação restrita a registrar uma escolha e fechar a janela. (TOTVS, s.d., ref. 1)
Sintaxe
@ <nLinha>, <nColuna> BUTTON <cTexto> SIZE <nLargura>, <nAltura> PIXEL OF <oObjetoRef> ACTION <expressao>Parâmetros
cTextoCaractereObrigatório
Texto do botão.
nLargura / nAlturaNuméricoObrigatório
Dimensões em pixels.
oObjetoRefObjetoObrigatório
Objeto pai.
expressaoQualquerObrigatório
Ação ao ativar o botão.
Retorno
Comando de criação de controle; não possui retorno de confirmação documentado.
Exemplo comentado
#Include "TOTVS.ch"
User Function EdButton()
Local oDlg
Local nEscolha := 0
DEFINE DIALOG oDlg TITLE "Teste editorial" FROM 0,0 TO 120,280 PIXEL
// Acao local: nenhuma gravacao.
@ 20,20 BUTTON "Confirmar" SIZE 80,20 PIXEL OF oDlg ACTION (nEscolha := 1, oDlg:End())
ACTIVATE DIALOG oDlg CENTERED
ConOut(cValToChar(nEscolha))
Return NilResultado esperado
Se a ação do botão ocorrer, nEscolha passa a 1; o valor começa em zero para distinguir fechamento sem essa ação. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Validar includes e variante do comando na versão utilizada. Não confundir aparência do botão com autorização para uma operação.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.