====== wButton ======
 
wButton es uno de los controles básicos de Néfele y tiene su equivalencia en el tag <button> de Html.

Su función es presentar un botón en la página web sobre el que podemos hacer click para provocar una acción.

===== Ejemplo de uso =====
{{url>https://samples.nefele.dev/wiki/wbutton  100%,120px}}
<Code:xailer linenums:1>
  WITH OBJECT WButton():New(:WO)
    :cId      := "Aceptar"
    :cText    := "Grabar la información"
    :cOnClick := "@alert('Grabada la información')"
    :cIcon    := "add"
    :lLarge   := .T.
    :lCenter  := .T.
    :Create()
  END WITH
</Code>

----


===== Propiedades =====

^Nombre         ^Init   ^Descripción                                                                     ^Versión ^
|aParams     |  {}   | Parametros extras a enviar al CGI { {"Param1","Valor1},{"Param2","Valor2"} } En caso de lSubmit:=.T. se envían todos los campos de edición por defecto|  0.1|
|cAction     |      | URL que será llamada al hacer Click, por defecto es el CGI que genero la página|  0.1|
|cAjaxBevel  |     | Bevel donde se incrusta el resultado si la llamada  cAction se ejecuta por [[tecnicas:Ajax]]|  0.1|
|cAjaxText   |      | Mensaje a poner debajo del Reloj de Actividad|  0.1|
|cBackIcon|  reply   | Icono por defecto a mostrar cuando es lModalClose |  0.2|
|cClrPane    |      | Por defecto coge el color de [[https://materializecss.com/color.html|Materializecss]] |  0.1|
|cClrPulse   |      | Color para el efecto Pulse se puede elegir uno [[https://materializecss.com/color.html|Materializecss]] |  0.1|
|cIcon       |      | Icono del Botón, se puede elegir uno de la lista de [[https://materializecss.com/icons.html|Materialize]] |  0.1|
|cIconAlign  |  [[nefele:constantes#alineaciones|xc_Left]]   | Alineación icono en el Botón |  0.1|
|cModalTarget   |      | Si el botón va a abrir una [[tecnicas:ventanas modales| ventana modal]], id de la ventana |  0.1|
|[[propiedades:cOnClick]]  |      | Función del CGI que se ejecuta al hacer click, si es lSubmit:=.T. no es necesario|  0.1|
|cPosition   |   [[nefele:constantes#alineaciones|xc_Center]]   | Posición del botón respecto a su contenedor  |  0.1|
|cSubmitIcon|  send  | Icono por defecto a mostrar cuando es lSubmit|  0.2|
|cSubmitForm|   | Si el wButton no esta dentro de un wForm, si queremos utilizarlo como Submit hay que indicarle cuales el cId del wForm|  0.2|
|cText       |      | Texto del Botón ( admite códigos de html )|  0.1|
|cTextAlign  |  [[nefele:constantes#alineaciones|xc_Center]]  | Alineación de texto en el botón|  0.1|
|lAjaxWaitON |  .T.  | Incluye un indicador de actividad mientras se ejecuta la función Ajax|  0.1|
|lBack      |  .F.     | Al pulsar el botón, retrocede a la página que ha llamado a la actual|  0.1|
|lBold    |  .F.     | Pone el texto del botón en **negrita** |  0.1|
|lCenter     |  .F.  | Se centra en su contenedor|  0.1|
|lClearFix     |  .F.  | Se asegura de que el botón inicie en una nueva fila |  0.1|
|lContainer  |  .T.  | El botón se encierra dentro de un contenedor tipo <div>|  0.1|
|lEncript    |  .T.  | Los parámetros del evento estarán encriptados en la pagina |  0.1|
|lFlat       |  .F.  | Habilita el modo [[https://materializecss.com/buttons.html#flat|Plano]]|  0.1|
|lFloating   |  .F.  | Habilita el modo [[https://materializecss.com/buttons.html#floating|Flotante]]|  0.1|
|lLarge      |  .F.     | Modo [[https://materializecss.com/buttons.html#large|largo]] del botón|  0.1|
|lModalClose  |  .F.   | Indica que el botón es el encargado de cerrar la [[tecnicas:ventanas modales| ventana modal]] que este abierta |  0.1|
|lModalResult  |  .F.   | Indica que el resultado de la llamada se presentará en una [[tecnicas:ventanas modales| ventana modal]], realizara la apertura de la ventana y luego ejecuta la llamada del CGI. |  0.1|
|lPulse      |  .F.  | Activa el efecto Pulse de [[https://materializecss.com/pulse.html|Materializecss]] haciendo que el botón destelle |  0.1|
|lRealButton |  .F.  | Se crean como "<button>" o como "<a>"  OJO no puede haber más que un lRealButton en un Form, el Submit y lo coge automático|  0.1|
|lShadowSheet |  .F.  | Presenta el ShadowSheet definido en [[controles:tWebPage]] al picar en el, de esa manera evitamos que puedan picar en cualquier otro control mientras se esta realizando la llamada a nuestro CGI, muy util en llamadas por [[tecnicas:Ajax]] o contra servidores lentos|  0.1|
|lSubmit  |  .F.  | [[https://materializecss.com/buttons.html#submit|Submit]] es el botón por defecto que se ejecuta al pulsar Intro en el formulario, solo puede existir uno en cada página|  0.1|
|nFix        |  0  | Ancho del Botón respecto a su contenedor( en cualquier medida válida css ) |  0.1|

===== Hereda de... =====
====== wControl ======
{{page>controles:wcontrol#propiedades}}

{{page>controles:wcontrol#metodos}}

~~DISCUSSION|Comentario wButton~~

/*{{tag>[nefele  primeros-pasos]}}*/