bAcaoBlocoObligatorio
Bloque de código ejecutado dentro de la ventana de procesamiento.
FUNCIóNPublicado
Processa
Processa( <bAcao>, [<cTitulo>], [<cMsg>], [<lAborta>] )Crea una ventana de procesamiento con barra de progreso para acompañar la ejecución de una acción.
Descripción general
Processa crea un diálogo con una barra de progreso y ejecuta una acción informada como bloque de código. La rutina llamada puede recibir una variable lógica por referencia para identificar solicitud de cancelación. Junto con ProcRegua e IncProc, permite informar el total de pasos y actualizar visualmente el avance del procesamiento.
Sintaxis
Processa( <bAcao>, [<cTitulo>], [<cMsg>], [<lAborta>] )Parámetros
cTituloCaractereOpcional
Título de la ventana.
cMsgCaractereOpcional
Mensaje presentado debajo de la barra de progreso.
lAbortaLógicoOpcional
Cuando es verdadero, habilita el botón de cancelación.
Retorno
Nil, conforme a la referencia de la Central TOTVS.
Crear ventana de progreso
#Include "TOTVS.ch"
User Function EjecutaProceso()
Local bAccion := {|lFin| U_ProcesaItems(@lFin)}
Local cTitulo := "Procesamiento"
Local cMsg := "Procesando items..."
Local lAborta := .T.
Processa(bAccion, cTitulo, cMsg, lAborta)
Return
User Function ProcesaItems(lFin)
Local nItem
Local nTotal := 100
ProcRegua(nTotal)
For nItem := 1 To nTotal
If lFin
Exit
EndIf
// Procese aquí el item.
IncProc()
Next nItem
ReturnResultado esperado
Processa abre la ventana; ProcRegua define 100 pasos e IncProc avanza la barra durante el For...Next.
- Use ProcRegua para informar el total de la barra dentro de la rutina procesada.
- Use IncProc para incrementar la barra por cada item procesado.
- Si lAborta está habilitado, trate la variable lógica recibida por la acción para finalizar con seguridad.
- No ignore la cancelación si la acción recibe la variable de control por referencia.
- No use Processa para tareas instantáneas; la ventana agrega complejidad sin beneficio para el usuario.
- Evite abrir Processa en ejecución sin interfaz.
Comentarios
Todavía no hay comentarios aprobados.
Inicia sesión con Google o Microsoft para comentar.