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

BUTTON()

@ <nLinha>, <nColuna> BUTTON <cTexto> SIZE <nLargura>, <nAltura> PIXEL OF <oObjetoRef> ACTION <expressao>

Documenta comando visual @ ... BUTTON de ficha TOTVS.

BUTTON()AdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

Aunque título oficial es BUTTON(), sintaxis documentada es comando @ con posición, texto, tamaño, objeto padre y acción. No es función Button() aislada. Esta variante usa BUTTON cTexto; ficha histórica relacionada documenta variante CAPTION que no debe mezclarse automáticamente. Ejemplo crea botón cuya acción solo registra elección y cierra diálogo. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

@ <nLinha>, <nColuna> BUTTON <cTexto> SIZE <nLargura>, <nAltura> PIXEL OF <oObjetoRef> ACTION <expressao>

Parámetros

nLinha / nColuna
NuméricoObligatorio

Posición del control.

cTexto
CarácterObligatorio

Texto del botón.

nLargura / nAltura
NuméricoObligatorio

Dimensiones en píxeles.

oObjetoRef
ObjetoObligatorio

Objeto padre.

expressao
CualquieraObligatorio

Acción al activar botón.

Retorno

Comando de creación de control; sin retorno de confirmación documentado.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "TOTVS.ch"
User Function EdButton()
    Local oDlg
    Local nEleccion := 0
    DEFINE DIALOG oDlg TITLE "Prueba editorial" FROM 0,0 TO 120,280 PIXEL
    // Accion local: sin grabacion.
    @ 20,20 BUTTON "Confirmar" SIZE 80,20 PIXEL OF oDlg ACTION (nEleccion := 1, oDlg:End())
    ACTIVATE DIALOG oDlg CENTERED
    ConOut(cValToChar(nEleccion))
Return Nil
Resultado esperado

Si se ejecuta acción del botón, nEleccion pasa a 1; empieza en cero para distinguir cierre sin acción. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Comprobar includes y variante del comando. Apariencia de botón no otorga autorización.
  • 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. BUTTON(). TDN. Sintaxe @ ... BUTTON. 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