DIALOG

El comando DIALOG presenta el formulario formulario al usuario. Este comando se utiliza con frecuencia para obtener información del usuario a través del uso de variables o para presentar información al usuario, como opciones para realizar una operación.

Es común presentar el formulario dentro de una ventana creada por el comando Open window.

Este es un ejemplo típico de un diálogo:

Utilice DIALOG en lugar de ALERT, CONFIRM o Request cuando la información que debe presentarse o reunirse es más compleja de lo que estos comandos pueden manejar.

Nota: es posible prohibir la entrada de datos en campos o cajas de diálogo (y limitar la entrada de datos a variables únicamente) utilizando una opción en las Preferencias de 4D (página Compatibilidad). Esta restricción corresponde al funcionamiento de versiones anteriores de 4D.

A diferencia de ADD RECORD o MODIFY RECORD, DIALOG no utiliza el formulario de entrada actual. Usted debe especificar el formulario (formulario proyecto o formulario tabla) a utilizar en el parámetro formulario. Igualmente, el panel de botones no se utiliza por defecto si se omiten los botones. En este caso, sólo la tecla Esc le permitirá salir del formulario.

El diálogo se acepta si el usuario hace clic en el botón Aceptar o presiona la tecla Enter (teclado numérico) o si se ejecuta el comando ACCEPT.
Recuerde que la validación no hace que se guarden los datos modificados: si el diálogo incluye campos, debe llamar explícitamente al comando SAVE RECORD para guardar los datos que hayan sido modificados.

El diálogo se cancela si el usuario hace clic en el botón Cancelar o presiona la tecla de anulación Esc o si se ejecuta el comando CANCEL.

Si pasa el parámetro opcional *, el formulario se carga y muestra en la última ventana del proceso actual y el comando termina su ejecución mientras deja el formulario activo en pantalla.

Este formulario luego reacciona "normalmente" a las acciones del usuario y se cierra vía una acción estándar o cuando el código 4D relacionado con el formulario (método objeto o método formulario) llama al comando CANCEL o ACCEPT. Si el proceso actual termina, los formularios creados de esta forma se cierran automáticamente de la misma forma que si se hubiera llamado el comando CANCEL. Este modo de apertura es particularmente útil para mostrar una paleta flotante con un documento, sin necesidad de otro proceso.

Notas:

• debe crear una ventana antes de llamar la instrucción DIALOG(form;*); si no es posible utilizar la ventana de diálogo actual en el proceso ni la ventana creada por defecto para cada proceso. De lo contrario, se genera el error -9909.
• Cuando se utiliza el parámetro *, la ventana se cierra automáticamente después de una acción estándar o una llamada al comando CANCEL o ACCEPT. No tiene que gestionar el cierre de la propia ventana.

El siguiente ejemplo muestra el uso del comando DIALOG para especificar los criterios de búsqueda. Un formulario personalizado que contiene las variables vNombre y vEstado le permite al usuario introducir los criterios de búsqueda.

El siguiente ejemplo puede usarse para crear una paleta de herramientas

Después de llamar a DIALOG, si se acepta el diálogo, la variable sistema OK toma el valor 1; si se cancela toma el valor 0.