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

Ambos lados, revisión anterior Revisión previa
Próxima revisión
Revisión previa
controles:wedit [05/01/2020 19:44]
pedro
controles:wedit [26/03/2022 12:16] (actual)
pedro [Ejemplo de uso]
Línea 1: Línea 1:
 ====== wEdit ====== ====== 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. 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]]. 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)   WITH OBJECT WEdit():​New(:​WO)
     :cId           := "​departamento"​     :cId           := "​departamento"​
-    :​cTitle ​       := "​Departamento"​ +    :​cTitle ​       := "​Departamento ​(cTitle)
-    :cIcon         := "lock+    :cHint         := "Indique departamento (cHint)
-    :nLength ​      := 10+    :cIcon         := "​folder_shared"​
     :​SetAutocomplete({"​Comercial","​Autoventa","​Preventa","​Postventa",;​     :​SetAutocomplete({"​Comercial","​Autoventa","​Preventa","​Postventa",;​
                       "​Administración","​Contabilidad","​Recursos Humanos",;​                       "​Administración","​Contabilidad","​Recursos Humanos",;​
Línea 19: Línea 28:
   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 29: 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 35: 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 ^
 +|aAutoComplete ​    ​| ​ {""​} ​ | Lista de valores a buscar en caso de xc_Autocomplete (**1**) |  0.1|
 |[[propiedades:​cClassId]] ​   |  edt   ​| ​ |  0.1| |[[propiedades:​cClassId]] ​   |  edt   ​| ​ |  0.1|
-|cIcon ​         |    | Icono junto al área de escritura, se puede elegir uno de la lista de [[https://​materializecss.com/​icons.html|Materialize]] |  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| |cName ​         |    | Nombre de la propiedad que recibe el CGI y que podrá leerse con [[ocgi:​getcgivalue|oCGI:​GetCgiValue]] ​ |  0.1|
-|[[contantes:​nStyle para wEdit|nStyle]] ​|  ​xc_Text ​ ​| ​Estilo de la Caja de Texto (ver en [[contantes:​nStyle para wEdit|constantes]]) ​ ​| ​ 0.1| +|cHelp                   | Texto de Ayuda debajo del control ​|  ​0.1| 
-|lAutoFocus ​       |  .f.  |  |  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| |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| |lSubmit ​          ​| ​ .f.  | Si es **.t.** un intro en este campo causa que se pulse sobre el botón submit |  0.1|
-|cHint                  Mensaje que aparece en el control cuando esta vacio no tiene el foco |  0.1| +|lValidate ​         ​.f.  ​Fuerza la validación del tipo de dato (xc_Numeric ​xc_Email) |  0.1| 
-|cHelp ​            ​     | Texto de Ayuda debajo ​del control |  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}}
  
-   ​PROPERTY lValidate ​        INIT .F.       // Fuerza la validación del tipo de dato 
  
-   ​PROPERTY lReadOnly ​        INIT .F.       // solo lectura+{{ youtube>​RmLM56p1B2M?​large }}
  
-   ​Property nLength ​          Init 0         // Longitud del campo 0 = indefinido si se indica una longitud no se dejarán introducir más que esos caracteres +~~DISCUSSION|Comentario wEdit~~
-   ​Property nMinValue ​        Init 0         // Valor mínimo (solo xc_Numeric) +
-   ​Property nMaxValue ​        Init 9999999999999 // Valor máximo (solo xc_Numeric) +
-   ​Property aAutoComplete ​    Init {""​} ​     //Lista de valores a buscar en caso de xc_Autocomplete son pares de valores el 1º es el valor que devuelve al seleccionarlo y el 2º el que se muestra+
  
-  ​ 
controles/wedit.1578253440.txt.gz · Última modificación: 21/07/2020 10:50 (editor externo)