WebForm
La clase WebForm contiene funciones y propiedades que permiten manejar sus componentes de páginas Qodly. Los objetos 4D.WebForm se instancian con el comando webForm.
Historia
| Lanzamiento | Modificaciones |
|---|---|
| 20 R6 | Adición de enableState() y disableState() |
| 20 R2 | Añadidos |
Comandos y funciones
que están disponibles directamente como propiedades |
| .disableState( state : string) desactiva la renderización del estado en la página web actual |
| .enableState( state : string ) activa la renderización del estado en la página web actual |
| .setError( msg : string) envía msg como mensaje de error a la página web |
| .setMessage( msg : string) envía msg como mensaje de información a la página web |
| .setWarning( msg : string) envía msg como mensaje de advertencia a la página web |
.componentName
.componentName : 4D.WebFormItem
Descripción
Los componentes de las páginas web son objetos que están disponibles directamente como propiedades de estas páginas web.
Los objetos devueltos son de la clase 4D.WebFormItem. Estos objetos tienen funciones que puede utilizar para gestionar sus componentes de forma dinámica.
Ejemplo
shared singleton Class constructor()
var myForm : 4D.WebForm
var component : 4D.WebFormItem
myForm:=webForm //devuelve la página web como un objeto, cada propiedad es un componente
component:=myForm.myImage //devuelve el componente myImage de la página web
Aunque myForm puede no mostrar las propiedades típicas de un objeto cuando se examina en el depurador, se comporta como si fuera el objeto webForm real. Puede interactuar con las propiedades y funciones del objeto webForm subyacente a través de myForm. Por ejemplo, puede manipular dinámicamente los componentes de la página o transmitir mensajes a las páginas web utilizando funciones especializadas como myForm.setMessage().
.disableState()
.disableState( state : string)
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| state | string | -> | Nombre del estado a desactivar de la página web |
Descripción
La función .disableState() desactiva la renderización del estado en la página web actual.
Esta función no hace nada si:
- el state no está habilitado actualmente en la página web,
- el estado no existe para la página web.
Si activa o desactiva varios estados en la misma función usuario, todas las modificaciones se envían al mismo tiempo al cliente una vez finalizada la función.
Para más información sobre los estados de las páginas web, consulte la sección Estados en la documentación de Qodly.
.enableState()
.enableState( state : string )
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| state | string | -> | Nombre del estado a activar en las páginas web |
Descripción
La función .enableState() activa la renderización del estado en la página web actual.
Esta función no hace nada si:
- el estado ya ha sido activado en la página web,
- el estado no existe para la página web.
Si activa o desactiva varios estados dentro de la misma función usuario, todas las modificaciones se envían al mismo tiempo al cliente una vez que la función termina.
Para más información sobre los estados de las páginas web, consulte la sección Estados en la documentación de Qodly.
Ejemplo
Usted activa un estado específico llamado "wrongCredentials" en caso de error en su página de conexión:
Function authenticationError()
If (Session.info.type#"remote")
Web Form.enableState("wrongCredentials")
End if
.setError()
.setError( msg : string)
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| msg | string | -> | Mensaje de error a mostrar en la página web |
Descripción
La función .setError() envía msg como mensaje de error a la página web.
La función devuelve una respuesta con un estado 200 OK y un objeto __WEBFORM en el cuerpo con una propiedad __NOTIFICATION.message definida como msg y un __NOTIFICATION.type definido como "error".
Ejemplo
shared singleton Class constructor()
exposed function myError()
var myForm : 4D.WebForm
myForm:=web Form
myForm.setError("My error message")
Si la funcionalidad Provide feedback está activada para el evento, el mensaje se muestra automáticamente como un toast rojo en la parte inferior de la página y desaparece automáticamente después de 5 segundos:
.setMessage()
.setMessage( msg : string)
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| msg | string | -> | Mensaje de información a mostrar en la página web |
Descripción
La función .setMessage() envía msg como mensaje de información a la página web.
La función devuelve una respuesta con un estado 200 OK y un objeto __WEBFORM en el cuerpo con una propiedad __NOTIFICATION.message definida como msg y un __NOTIFICATION.type definido como "message".
Ejemplo
shared singleton Class constructor()
exposed function myMessage()
var myForm : 4D.WebForm
myForm:=web Form
myForm.setMessage("My information message")
Si la funcionalidad Provide feedback está activada para el evento, el mensaje se muestra automáticamente como un toast verde en la parte inferior de la página y desaparece automáticamente después de 5 segundos:
.setWarning()
.setWarning( msg : string)
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| msg | string | -> | Mensaje de advertencia para mostrar en la página web |
Descripción
La función .setWarning() envía msg como mensaje de advertencia a la página web.
La función devuelve una respuesta con un estado 200 OK y un objeto __WEBFORM en el cuerpo con una propiedad __NOTIFICATION.message definida como msg y un __NOTIFICATION.type definido como "warning".
Ejemplo
shared singleton Class constructor()
exposed function myWarning()
var myForm : 4D.WebForm
myForm:=web Form
myForm.setWarning("My warning message")
Si la funcionalidad Provide feedback está activada para el evento, el mensaje se muestra automáticamente como un toast amarillo en la parte inferior de la página web y desaparece automáticamente después de 5 segundos:
