Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

IncProc

IncProc()

Incrementa a régua de progressão criada por Processa().

FrameworkProcessamentoRégua de progressoInterface
01 · VISÃO GERAL

Visão geral

IncProc() avança em uma unidade a régua de progresso preparada dentro de uma rotina executada por Processa(). Normalmente é usada em laços de processamento para sinalizar visualmente ao usuário que a rotina continua em execução.

02 · SINTAXE

Sintaxe

IncProc()
03 · EXEMPLO PRÁTICO

Incrementando a régua de Processa

#Include "TOTVS.ch"

User Function ExIncProc()
    Local bAcao := {|lFim| U_Executa(@lFim) }

    Processa(bAcao, "Processamento", "Processando registros...", .T.)
Return

User Function Executa(lFim)
    Local nItem

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

        // Processa o item atual
        IncProc()
    Next
Return
Resultado esperado

ProcRegua() define o total e IncProc() avança a régua a cada item processado.

BOAS PRÁTICAS
  • Use ProcRegua() antes do laço para informar o total esperado de passos.
  • Chame IncProc() a cada item efetivamente processado.
  • Quando Processa() permitir cancelamento, respeite o parâmetro lógico recebido pelo bloco de ação.
ARMADILHAS COMUNS
  • Sem ProcRegua(), a régua pode não refletir corretamente o percentual de execução.
  • Incrementar a régua fora da mesma rotina controlada por Processa() dificulta entender o fluxo.
  • Como a referência usada é histórica, valide comportamento em releases atuais do Protheus.

Conteúdos relacionados

REFERÊNCIAS
  1. 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.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha