FUNCIóNEn revisión

ProcRegua

ProcRegua( <nTotal> )

Define el valor total de la barra de progreso usada por Processa().

FrameworkProcesamientoBarra de progreso

01 · DESCRIPCIÓN GENERAL

Descripción general

ProcRegua() informa a la barra de Processa() cuántas etapas serán ejecutadas. Después, cada llamada a IncProc() incrementa la posición de la barra hasta completar el total definido.

02 · SINTAXIS

Sintaxis

ProcRegua( <nTotal> )

Parámetros

nTotal

NuméricoObligatorio

Cantidad total de pasos que la rutina pretende ejecutar.

03 · EJEMPLO PRÁCTICO

Definiendo el total de elementos

#Include "TOTVS.ch"

Static Function ProcessaItens(aItens, lFim)
    Local nItem

    ProcRegua(Len(aItens))
    For nItem := 1 To Len(aItens)
        If lFim
            Exit
        EndIf

        // Processamento do item
        IncProc()
    Next
Return

Resultado esperado

La barra pasa a representar la cantidad de elementos del array.

BUENAS PRÁCTICAS

Defina o total antes de iniciar o laço principal.
Se o total for calculado por consulta ou array, use a quantidade real de registros.
Combine com IncProc() para atualizar a régua durante o processamento.

Contenido relacionado

REFERENCIAS

Help ADVPL.chm. Help AdvPL/APMSLib, documentação oficial histórica, 15 mar. 2004. Conteúdo resumido, reorganizado e marcado para revisão contra documentação atual da TOTVS quando disponível.

Estado: En revisión
Página creada el: 25/08/2026 às 00:20
Última revisión el: 25/08/2026 às 00:20
Idioma original: Portugués
Revisión: Usina.BR