Saltar al contenido principal
Versión: 20 R10

VP FLUSH COMMANDS

Historia
LanzamientoModificaciones
20 R9Soporte del parámetro callback

VP FLUSH COMMANDS ( vpAreaName : Text {; callback : 4D.Function} )

ParámetrosTipoDescripción
vpAreaNameText->Nombre de objeto formulario área 4D View Pro
retrollamada4D.Function->(Opcional) Una función de retrollamada que se ejecuta después de que se hayan ejecutado todos los comandos VP y las funciones personalizadas de 4D

Descripción

El comando VP FLUSH COMMANDS ejecuta inmediatamente los comandos almacenados y borra el buffer de comandos.

En vpAreaName, pase el nombre del área 4D View Pro. Si pasa un nombre que no existe, se devuelve un error.

Para aumentar el rendimiento y reducir el número de peticiones enviadas, los comandos 4D View Pro llamados por el desarrollador se almacenan en un buffer de comandos. Cuando se llama, VP FLUSH COMMANDS ejecuta los comandos como un lote al salir del método y vacía el contenido del buffer de comandos.

Si se ofrece una función callback, sólo se ejecuta después de que todos los comandos almacenados y las funciones personalizadas 4D hayan terminado de procesarse. Esto garantiza que cualquier acción posterior, como guardar o imprimir el documento, sólo se realice una vez que se hayan completado todos los cálculos.

Los siguientes parámetros se pueden utilizar en la función de retrollamada:

ParámetrosTipoDescripción
param1TextEl nombre del objeto de área 4D View Pro
param2ObjectUn objeto devuelto por el método con un mensaje de estado
.successBooleanTrue si la importación se ha realizado correctamente, False en caso contrario
.errorCodeIntegerCódigo de error
.errorMessageTextMensaje de error

Ejemplo 1

Desea ejecutar comandos y vaciar el búfer de comandos:

// Definir valores de texto en celdas específicas
VP SET TEXT VALUE(VP Cell("ViewProArea1";10;1); "INVOICE")
VP SET TEXT VALUE(VP Cell("ViewProArea1";10;2);"Invoice date: ")
VP SET TEXT VALUE(VP Cell("ViewProArea1";10;3);"Due date: ")

// Ejecutar los comandos almacenados, borrar la memoria intermedia y activar la llamada de retorno
VP FLUSH COMMANDS("ViewProArea1")

Ejemplo 2

Desea ejecutar comandos, vaciar el búfer de comandos y activar una función de retrollamada:

// Definir valores de texto en celdas específicas
VP SET FORMULA(VP Cell("ViewProArea1";10;1); "MyCustomFunction()")
VP SET FORMULA(VP Cell("ViewProArea1";10;2); "MyCustomFunction2()")
VP SET FORMULA(VP Cell("ViewProArea1";10;3); "MyCustomFunction3()")

// Ejecutar los comandos almacenados, borrar la memoria intermedia y activar la retrollamada
VP FLUSH COMMANDS("ViewProArea1"; Formula(onFlushComplete))
// Método 'onFlushComplete'
#DECLARE($name : Text; $status : Object)
ALERT("All commands and custom functions have finished executing. You can now print or save the document.")