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
vbModelesspara o resto do código continuar - 14:17 - Cálculo do andamento e da largura atual do quadro a partir do total
- 18:24 -
DoEventspara 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 Forpara 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
Showtrava o resto da execução; em modovbModelessele 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
DoEventso 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:

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:

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:
<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:
- Dimensionar:
- As variáveis “i”, “ultLin” e “cont” como números do tipo Long
- Armazenar na variável “ultLin” o número da linha da última célula preenchida da coluna A
- Invocar a função abrirBarraProgresso
<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
<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
<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:

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!

