====== wEdit ======
Este control nos permite la introducción de datos en el AppWeb para que luego pueda ser enviado a nuestro CGI, puede ser Alfanumérico, Numérico, Contraseña, Email, Memo y Autocompletado.

Como Edit Memo el alto es dinámico para que quepa el texto.

Este control puede también funcionar como Date y Time, pero creemos que es mas interesante utilizar [[controles:wDatePicker]] y [[controles:wTimePicker]], que en el fondo heredan de wEdit pero añaden funcionalidades más visuales.

Si es parte de un [[controles:wForm]] al hacer el submit, se utiliza la propiedad cName como parámetro que recibirá el CGI, si no se define esta propiedad se le asignara el [[propiedades:cId]].

===== Ejemplo de uso =====

{{url>https://samples.nefele.dev/wiki/wedit  100%,360px}}

----

<Code:xailer linenums:1>
  WITH OBJECT WEdit():New(:WO)
    :cId           := "departamento"
    :cTitle        := "Departamento (cTitle)"
    :cHint         := "Indique departamento (cHint)"
    :cIcon         := "folder_shared"
    :SetAutocomplete({"Comercial","Autoventa","Preventa","Postventa",;
                      "Administración","Contabilidad","Recursos Humanos",;
                      "Dirección"})
    :SetRequired()
    :Create()
  END WITH
  WITH OBJECT WEdit():New(:WO)
    :cId           := "nombre"
    :cTitle        := "Nombre (cTitle)"
    :cIcon         := "person"
    :nLength       := 25
    :SetRequired()
    :Create()
  END WITH
  WITH OBJECT WEdit():New(:WO)
    :cId           := "password"
    :cTitle        := "Password"
    :cIcon         := "lock"
    :cHelp         := "Recuerde usar siempre contraseñas seguras (cHelp)"
    :nLength       := 10
    :lSubmit       := .T.
    :SetPassword()
    :SetRequired()
    :Create()
  END WITH
</Code>

----
===== Propiedades =====

^Nombre         ^Init   ^Descripción                                                                     ^Versión ^
|aAutoComplete     |  {""}  | Lista de valores a buscar en caso de xc_Autocomplete (**1**) |  0.1|
|[[propiedades:cClassId]]    |  edt   |  |  0.1|
|[[propiedades:cIcon]] |    | Icono junto al área de escritura, se puede elegir uno de la lista de [[https://materializecss.com/icons.html|Materialize]] |  0.1|
|cName          |    | Nombre de la propiedad que recibe el CGI y que podrá leerse con [[ocgi:getcgivalue|oCGI:GetCgiValue]]  |  0.1|
|cHelp             |       | Texto de Ayuda debajo del control |  0.1|
|cHint             |       | Mensaje que aparece en el control cuando esta vació\\ Si está vacío pero existe cTitle, mostrará este último en su lugar |  0.1|
|cTitle            |       | Texto que aparecerá en la cabecera del control, si no existe cHint y no tiene el foco hace la función de cHint, al tomar el foco sube a su posición |  0.1
|nLength           |  0    | Longitud del campo 0 = indefinido si se indica una longitud no se dejarán introducir más que esos caracteres  |  0.1|
|lAutoFocus        |  .f.  | Fuerza a que sea el control que reciba el foco al cargar la página |  0.1|
|lAutoSelect       |  .t.  | Selecciona el contenido del control al hacer click con el ratón |  0.1|
|lReadOnly         |  .f.  | Activa el modo solo lectura |  0.1|
|lRequired         |  .f.  | Es un campo obligatorio |  0.1|
|lSubmit           |  .f.  | Si es **.t.** un intro en este campo causa que se pulse sobre el botón submit |  0.1|
|lValidate         |  .f.  | Fuerza la validación del tipo de dato (xc_Numeric y xc_Email) |  0.1|
|cHelpMargin       |  -2px   | Margen superior para el cHelp  |  0.1|
|ccHelpWidth       |  initial  | Anchura para el cHelp  |  0.1|
|nMaxValue         |       | Valor máximo admitido  |  0.1|
|nPreviewStyle     |   1   | Valor por defecto para el [[preview]] del control |  0.1|
|nMinValue         |       | Valor mínimo admitido  |  0.1|
|[[nefele:constantes#nStyle para wEdit|nStyle]] |  xc_Text  | Estilo de la Caja de Texto (ver en [[nefele:constantes#nStyle para wEdit|constantes]])  |  0.1|
|[[oMask]]         |       | Objeto para el manejo de pictures del control  |  0.1|


  1.- Puede ser un array simple de elementos {"elem1","elem2",...},
      un array de array de elementos {{"elem1"},{"elem2"},...} que es lo que nos devuelve QueryArray,
      o un array de array de Pares {{"elem1","imagen1"},{"elem2","imagen2"},...} 
      para incluir una imagen a la derecha de cada elemento


===== Metodos =====
^Nombre         ^Descripción                                                                     ^Versión ^
|SetNumeric  | Define el control como Numérico |  0.1|
|SetPassword | Define el control como Password |  0.1|
|SetEmail    | Define el control como Email    |  0.1|
|SetMemo     | Define el control como Memo     |  0.1|
|SetText     | Define el control como Texto    |  0.1|
|SetAutocomplete(aAutoComplete)| Habilita el modo AutoCompletar y asigna el array de elementos (**1**) |  0.1|
|SetRequired | Asignación rapida de lRequired |  0.1|
|SetSubmit   | Asignación rapida de lSubmit |  0.1|
|SetValidate | Asignación rapida de lValidate |  0.1|

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

{{page>controles:wcontrol#metodos}}


{{ youtube>RmLM56p1B2M?large }}

~~DISCUSSION|Comentario wEdit~~