Muestra las diferencias entre dos versiones de la página.
| 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 y no tiene el foco | 0.1| | + | |lValidate | .f. | Fuerza la validación del tipo de dato (xc_Numeric y 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 | + | |
| - | | ||