FUNCIóNEn revisión

RptStatus

RptStatus( <bAcao>, [cTitulo], [cMsg] )

Muestra un diálogo de seguimiento con barra de progreso.

InformesInterfazProcesamientoBarra de progreso

01 · DESCRIPCIÓN GENERAL

Descripción general

RptStatus() ejecuta un bloque de código dentro de una ventana de estado, permitiendo acompañar visualmente informes o rutinas largas. La barra se prepara con SetRegua() y se incrementa con IncRegua().

02 · SINTAXIS

Sintaxis

RptStatus( <bAcao>, [cTitulo], [cMsg] )

Parámetros

bAccion

Bloque de códigoObligatorio

Bloque ejecutado por la rutina. Puede recibir un parámetro lógico que indica cancelación.

cTitulo

CarácterOpcional

Título mostrado en la ventana.

cMensaje

CarácterOpcional

Mensaje mostrado debajo de la barra de progreso.

03 · EJEMPLO PRÁCTICO

Estado de procesamiento

#Include "TOTVS.ch"

User Function ExRptStatus()
    Local bAcao := {|lFim| U_ProcessaRel(@lFim) }

    RptStatus(bAcao, "Relatório", "Preparando dados...")
Return

Resultado esperado

La función abre una ventana de estado y ejecuta el bloque indicado.

BUENAS PRÁCTICAS

Use para rotinas cujo progresso precisa ser comunicado ao usuário.
Dentro do bloco, inicialize a régua com SetRegua().
Atualize a régua com IncRegua() a cada etapa concluída.

ERRORES COMUNES

Evita mensajes demasiado genéricos; informa al usuario qué se está procesando.
Si hay cancelación, trata el parámetro lógico antes de continuar.
Como es una API histórica, valida la compatibilidad visual en el SmartClient utilizado.

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