FUNCIóNEn revisión

SetRegua

SetRegua( <nTotal> )

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

InformesProcesamientoBarra de progreso

01 · DESCRIPCIÓN GENERAL

Descripción general

SetRegua() prepara la barra de progreso exhibida por RptStatus(), informando la cantidad total de pasos de una rutina de informe o procesamiento con seguimiento visual.

02 · SINTAXIS

Sintaxis

SetRegua( <nTotal> )

Parámetros

nTotal

NuméricoObligatorio

Valor total de la barra de progreso.

03 · EJEMPLO PRÁCTICO

Barra en informe

#Include "TOTVS.ch"

User Function ExSetRegua()
    Local bAcao := {|lFim| U_GeraRel(@lFim) }

    RptStatus(bAcao, "Relatório", "Gerando informações...")
Return

User Function GeraRel(lFim)
    Local nLinha

    SetRegua(50)
    For nLinha := 1 To 50
        If lFim
            Exit
        EndIf

        IncRegua()
    Next
Return

Resultado esperado

SetRegua() define el total e IncRegua() actualiza el avance dentro de RptStatus().

BUENAS PRÁCTICAS

Use SetRegua() em conjunto com RptStatus() e IncRegua().
A diferença principal em relação a ProcRegua() é o contexto: SetRegua() aparece associado ao fluxo de RptStatus().
Mantenha a contagem alinhada ao número real de incrementos.

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