Herramientas de usuario

Herramientas del sitio


controles:wedit

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Próxima revisión
Revisión previa
controles:wedit [05/01/2020 19:11]
pedro creado
controles:wedit [26/03/2022 12:16] (actual)
pedro [Ejemplo de uso]
Línea 2: Línea 2:
 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. 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 ===== ===== Ejemplo de uso =====
 +
 +{{url>​https://​samples.nefele.dev/​wiki/​wedit ​ 100%,​360px}}
 +
 +----
 +
 <​Code:​xailer linenums:​1>​ <​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)   WITH OBJECT WEdit():​New(:​WO)
     :cId           := "​nombre"​     :cId           := "​nombre"​
-    :​cTitle ​       := "​Nombre"​+    :​cTitle ​       := "​Nombre ​(cTitle)"
     :​cIcon ​        := "​person"​     :​cIcon ​        := "​person"​
-    :​nLength ​      :​= ​15+    :​nLength ​      :​= ​25
     :​SetRequired()     :​SetRequired()
     :Create()     :Create()
Línea 19: Línea 38:
     :​cTitle ​       := "​Password"​     :​cTitle ​       := "​Password"​
     :​cIcon ​        := "​lock"​     :​cIcon ​        := "​lock"​
 +    :​cHelp ​        := "​Recuerde usar siempre contraseñas seguras (cHelp)"​
     :​nLength ​      := 10     :​nLength ​      := 10
 +    :​lSubmit ​      := .T.
     :​SetPassword()     :​SetPassword()
     :​SetRequired()     :​SetRequired()
Línea 25: Línea 46:
   END WITH   END WITH
 </​Code>​ </​Code>​
-{{url>​https://​samples.nefele.dev/​wedit ​ 100%,​300px}}+
 ---- ----
 ===== Propiedades ===== ===== Propiedades =====
  
 ^Nombre ​        ​^Init ​  ​^Descripción ​                                                                    ​^Versión ^ ^Nombre ​        ​^Init ​  ​^Descripción ​                                                                    ​^Versión ^
-|[[propiedades:​cClassId]] ​   |  ​dpk   |  |  0.1| +|aAutoComplete ​    ​| ​ {""​} ​ | Lista de valores a buscar en caso de xc_Autocomplete (**1**) |  0.1| 
-|cIcon ​            ​ ​date_range  ​| Icono junto al edit, se puede elegir uno de la lista de [[https://​materializecss.com/​icons.html|Materialize]] |  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~~ 
controles/wedit.1578251515.txt.gz · Última modificación: 21/07/2020 10:50 (editor externo)