El control wForm es el contenedor estándar para el tratamiento de formularios, equivale a <form></form> de HTML.

Puede contener cualquier control de edición de datos, para una vez realizado el submit enviar el valor de todos los controles a nuestro CGI para poder tratarlos.

Para realizar en envió (submit) sera necesario añadir un wButton con la propiedad lSubmit a .T., solo puede existir un botón submit en cada formulario, también podemos asignarle la funcionalidad submit a un wEdit que este en el formulario.

Normalmente en los formularios HTML cuando en un campo de texto pulsamos [Intro] se ejecuta el submit de dicho formulario. En Néfele, al pulsar [Intro] pasamos el foco al siguiente control, excepto que dicho wEdit tenga su propiedad lSubmit a .T., asignándola directamente o utilizando el método :SetSubmit(), en ese caso se ejecutaría el submit del formulario al pulsar [Intro] en dicho control.

El Submit enviara al CGI un parámetro por cada control, siempre que tengan algún valor, por ejemplo los wCheck si están a False no se envía ningún parámetro, por eso es muy practico utilizar le método oCGI:GetCGIValue con el parámetro xdefault con el valor que nos debe retornar en caso de que no venga.

Los controles que permitan múltiples valores, retornaran un array por lo que es más apropiado tratarlos con oCGI:GetCGIArray.

En HTML los controles que estén disabled, por defecto no se envían en el submit, tengan o no valor. En Néfele si tiene valor se tratan como al resto de controles.

Por defecto se le asigna el foco al primer control del Formulario que permita edición, si queremos que sea otro deberemos indicarlo en la propiedad lAutoFocus de dicho control, y habilitar la propiedad lNoAutoFocus del Formulario.

   WITH OBJECT WBevel():New(o)
      :cTitle      := "Introduzca Usuario y Contraseña"
      :cTitleAlign := xc_Center
      :aWidth      := {12,8}
      :aOffset     := {,2}
      WITH OBJECT WForm():New(:WO)
         :cFunction := "visparam"
         WITH OBJECT WEdit():New(:WO)
            :cId   := "usuario"
            :cHint := "Usuario"
            :cIcon := "person"
            :SetRequired()
            :Create()
         END WITH
         WITH OBJECT WEdit():New(:WO)
            :cId   := "password"
            :cHint := "Password"
            :cIcon := "vpn_key"
            :SetPassword()
            :SetRequired()
            :Create()
         END WITH
         :Create()
      END WITH
      :Create()
   END WITH