Barra de Progresso no Excel para Monitorar seus Códigos em VBA

Você sabia que é possível criar uma barra de progresso no Excel para monitorar seus códigos em VBA enquanto estão rodando?

Caso prefira esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo!

O que você aprende neste vídeo

Resposta rápida: A aula cria uma barra de progresso para acompanhar uma macro em VBA, usando um formulário com um rótulo de texto e um quadro que vai enchendo. Três funções abrem, atualizam e fecham a barra, e o exemplo é uma macro que exclui linhas da tabela, com o contador ajustado a cada exclusão.

Neste vídeo (24 min):

  • 0:05 - A barra em ação: caixa com o percentual de andamento enquanto uma macro exclui linhas da tabela
  • 1:29 - A barra de progresso é um formulário do VBA com um texto e um quadro
  • 2:00 - Inserir o formulário e dar a ele um nome sem espaço nem caractere especial
  • 2:53 - Montar o rótulo com o texto 0% completo e o quadro que será a barra
  • 8:10 - Anotar a largura total do quadro, que entra nas contas do código
  • 10:00 - As funções de abrir, fechar e atualizar a barra, criadas para não repetir código na macro
  • 11:18 - Função de abrir: zera a largura do quadro e exibe o formulário
  • 12:18 - Exibir o formulário em modo vbModeless para o resto do código continuar
  • 14:17 - Cálculo do andamento e da largura atual do quadro a partir do total
  • 18:24 - DoEvents para a barra aparecer atualizada a cada volta
  • 19:32 - Ajuste do contador depois de excluir cada linha
  • 22:24 - Teste da célula vazia com Exit For para o código terminar

Trechos do vídeo:

  • Dê ao formulário e aos objetos nomes intuitivos, sem espaço nem caractere especial, porque isso dificulta escrever o código depois e pode dar erro.
  • O formulário aberto só com Show trava o resto da execução; em modo vbModeless ele só exibe e o código continua rodando.
  • O percentual do texto é o andamento multiplicado por 100, arredondado para zero casas decimais, e a largura do quadro é a largura total multiplicada pelo andamento.
  • Sem DoEvents o VBA tenta usar o mínimo de processamento e não mostra a atualização da barra, que é justamente o que a barra existe para mostrar.
  • Ao excluir linhas dentro de um laço, o contador precisa voltar uma unidade, senão a linha seguinte à excluída não é analisada.

Para receber por e-mail o(s) arquivo(s) utilizados na aula, preencha:

Fala, Impressionadores! Hoje vamos te mostrar como criar uma barra de progresso no Excel!

Com ela você vai conseguir ver o progresso do seu código dentro do Excel enquanto ele está funcionando.

E aí, prontos para ver como fazer para monitorar seus códigos enquanto eles estão sendo executados?

No arquivo disponibilizado para a aula de hoje, temos dados numa tabela de atendimentos de uma empresa.

Registros feitos são o ID do atendimento, sua data, qual o código do cliente, total de tempo gasto, e o atendente da empresa. Veja abaixo a tabela com algumas das informações:

Ícone VBAVBA Impressionador

Como automatizar praticamente qualquer tarefa repetitiva que você faça dentro do Excel. Aprenda a criar integrações do Excel com o PowerPoint, Word, Outlook e muito mais. Aprenda a criar automações para resolver tudo com apenas um clique em um botão. Tudo isso com uma única linguagem que junta todos esses programas.

Black Friday · Lote Especial · Lote 1 · Último Lote

De R$ 1.497 56% OFF54% OFF53% OFF

por 12x R$ 6467,5069

Preço do Lote Especial por tempo limitadoPreço do Lote Especial só até amanhã, 13/11, às 23h59Preço do Lote Especial até 13/11, às 23h59Último dia do Lote Especial: o preço vale até hoje, às 23h59Preço do Lote 1 por tempo limitadoPreço do Lote 1 só até amanhã, 20/11, às 23h59Preço do Lote 1 até 20/11, às 23h59Último dia do Lote 1: o preço vale até hoje, às 23h59Preço do Último Lote por tempo limitadoPreço do Último Lote só até amanhã, 27/11, às 23h59Preço do Último Lote até 27/11, às 23h59Último dia do Último Lote: o preço vale até hoje, às 23h59

Começar agoraQuero a oferta de Black FridaySeta para a direita
Fundo VBATelas VBA
Macros no VBA
Macros no VBA

Vamos utilizar um formulário em VBA personalizado, que vai simular simplesmente a barra de progresso para VBA.

Criados os objetos que vão compor o formulário, e feitas as devidas personalizações visuais, teremos o seguinte cenário:

Barra de progresso VBA
Barra de progresso VBA

Agora partiremos para o código que será responsável por configurar e programar de fato a nossa barra de progresso para monitorar códigos.

Ela será composta de uma sub principal com a estrutura de cálculo, e de 3 funções auxiliares: uma para invocar a abertura, outra para fazer os cálculos e configurar a barra, e outra para fechar o formulário.

A seguir temos os códigos, e os comentários:

VBA
<strong>Sub excluirLinhas()</strong><br><br><strong>Dim i As Long, ultLin As Long, cont As Long</strong><br><br><strong>ultLin = Range("A1048576").End(xlUp).Row</strong><br><br><strong>abrirBarraProgresso</strong><br><br><strong>cont = 1</strong><br><br><strong>For i = 2 To ultLin</strong><br><strong>    If Cells(i, 1).Value = "" Then Exit For</strong> <br><br><strong>    Rows(i).Delete shift:=xlUp</strong><strong>    </strong><br><br><strong>    progredirBarraProgresso (cont / (ultLin - 1))</strong><br><br><strong>    DoEvents</strong><br><br><strong>    cont = cont + 1</strong>  <br><br><strong>    i = i - 1</strong><br><br><strong>Next</strong><br><br><strong>fecharBarraProgresso</strong><strong> </strong><br><br><strong>End Sub</strong>

 Comentários a respeito da sub excluirLinhas:

VBA
<strong>Function abrirBarraProgresso()</strong><br><br><strong>BarraDeProgresso.quadroProgresso.Width = 0</strong><br><strong>BarraDeProgresso.Show (vbModeless)</strong><br> <br><strong>End Function</strong>
  • Fazer a largura (width, em inglês) do quadroProgresso (nosso objeto que de fato representa a barra de progresso) ser igual a 0. Nesse momento a barra está programada para estar vazia
  • Mostrar o formulário BarraDeProgresso (Formulário inteiro)
  • Em seguida (voltando para a sub), armazenar o número 1 no contador “cont”
  • Usar uma estrutura de repetição For, que vai executar as seguintes ações repetidas enquanto a variável “i” assumir valores entre 2 e o valor representado pela “ultLin”:
    • Aplicar uma comparação através de uma estrutura If, para verificar se a célula da primeira coluna estiver vazia. Se estiver, abortar a estrutura de repetição
    • Deletar a linha inteira representada pela variável “i”, se a célula da primeira coluna (a cada linha) não estiver vazia (está preenchida)
    • Invocar a função progredirBarraProgresso, passando para ela a divisão das seguintes variáveis: “cont” e “ultLin”-1, que será de fato o “andamento” do código
VBA
<strong>Function progredirBarraProgresso(andamento As Double)<br></strong><br><strong>widthTotal = 216</strong><br><strong>widthAtual = widthTotal * andamento</strong><br><br><strong>BarraDeProgresso.quadroProgresso.Width = widthAtual</strong><br><strong>BarraDeProgresso.textoAndamento.Caption = Round(andamento * 100, 0) & "% Completo"</strong><br><br><strong>End Function</strong>
  • Armazenar na variável “widthTotal” o valor 216 (tamanho máximo da barra)
  • Armazenar na variável “widthAtual” o resultante da multiplicação do “andamento” (que é a razão entre “cont” e “ultLin”-1) e o widthTotal (216)
  • Passar para a propriedade de largura do quadroProgresso, do formulário BarraDeProgresso o que estiver na variável “widthAtual”. Aqui será de fato da barra estará preenchida, de seu total
  • Passar para a propriedade de texto do textoAndamento (label que vai representar o título do nosso formulário), do formulário BarraDeProgresso o que for resultante do arredondamento do “andamento” para porcentagem. Aqui será de fato escrito o quanto da barra estará preenchido, de 100% (para acompanhar o tamanho da barra preenchida.
  • Voltando à sub, “mandaremos” o Excel deixar vermos os eventos acontecerem normalmente na planilha. Dessa forma, conseguiremos ver a barra “andando” e as coisas acontecendo. Caso contrário, não veríamos nem a barra andando, nem o processo acontecer
  • Adicionar 1 unidade na nossa variável contadora “cont”
  • Diminuir 1 unidade na nossa variável “i”, porque excluímos uma linha. Exemplo:
    • Temos duas linas, uma linha imediatamente abaixo (exemplo: 3) da linha a ser excluída (exemplo: 2)
    • Inicialmente elas são as linhas 2 e 3
    • Se eu excluir a linha 2, a linha 3 se torna linha 2
    • Então, se não fizermos essa diminuição de 1 unidade, a linha 2 ficaria sem ser analisada, porque a variável “i” assumiria 3, e essa “nova” linha 2 ficaria “de fora” da análise
  • Fazer essas ações para todas as linhas da tabela
  • Invocar a função fecharBarraProgresso, que vai simplesmente descarregar o formulário BarraDeProgresso
VBA
<strong>Function fecharBarraProgresso()<br></strong><br><strong>Unload BarraDeProgresso</strong><br><br><strong>End Function</strong>

Assim, se encerra a nossa sub de como monitorar códigos em VBA.

A seguir, mostramos diversos momentos de funcionamento desse código que simula uma barra de progresso em VBA. Veja:

Barra de progresso Excel
Barra de progresso Excel

Conclusão – Barra de Progresso no Excel

Hoje você aprendeu como criar barra de progresso no Excel!

Ela é constituída por um formulário em VBA, algumas estruturas famosas como a estrutura de repetição for e a estrutura condicional if, além de diversos conceitos legais de VBA.

Valeu, pessoal! Fique ligado no nosso canal do Youtube para mais conteúdo de VBA!

Hashtag Treinamentos

Para acessar outras publicações de VBA, clique aqui!


Quer aprender mais sobre VBA com um minicurso básico gratuito?