VBA – Agendando a execução de macros com a função OnTime

Introdução

Uma necessidade muito comum em aplicativos é utilizar critérios de tempo para execução de algumas rotinas. Esta é uma tarefa trivial em várias linguagens, mas poucos pensam em utilizá-la no VBA por achar muito complexo, tendo que envolver chamadas de API e outros recursos mais avançados da linguagem

Porém, o VBA do Microsoft Excel disponibiliza um método que facilita esse tipo de trabalho, o método OnTime().

O que é

O método OnTime programa um procedimento para ser executado em um momento especificado no futuro (seja em uma determinada hora do dia ou após uma quantidade específica de tempo decorrido).

A estrutura de chamada à função OnTime se faz da seguinte forma:

Application.OnTime([EarliestTime], [Procedure], [LatestTime], [Schedule])

Argumentos da função:

EarliestTime

Variant necessário. Especifica quando você deseja que esse procedimento seja executado.

Procedure

String necessário. O nome do procedimento a ser executado.

LatestTime

Variant opcional. Especifica até quando o procedimento pode ser executado. Por exemplo, se LatestTime estiver definido como EarliestTime + 30 e o Microsoft Excel não estiver em modo Pronto, Copiar, Recortar ou Localizar em EarliestTime devido a um outro procedimento estar sendo executado, o Microsoft Excel esperará 30 segundos para que o primeiro procedimento termine. Se o Microsoft Excel não estiver em modo Pronto dentro de 30 segundos, o procedimento não será executado. Se esse argumento for omitido, o Microsoft Excel esperará até que o procedimento possa ser executado.

Schedule

Variant opcional. True para programar um novo procedimento OnTime. False para limpar um procedimento definido anteriormente. O valor padrão é True.

Exemplo

Para informar ao VBA um valor de data válido para execução do método OnTime, usa-se a propriedade Now do VBA juntamente com a função TimeValue( . Somando as duas, é possível programar o procedimento para ser executado quando uma quantidade de tempo específica (contando a partir de agora) tiver decorrido.

Caso seja necessário informar uma hora específica, por exemplo, 3 da tarde (ou 15:00), usa-se TimeValue(time) onde time é um valor de hora informado através de uma String.

Veja os exemplos de código abaixo:

Public Sub ExecutaOnTime()
MsgBox "Opa! Executou."
End Sub
Public Sub TesteOnTime()
Call Application.OnTime(Now +
TimeValue("00:00:10"), "ExecutaOnTime")
End Sub

Execute a função TesteOnTime, deixando o cursor do mouse sobre ele (linha 5 a 6) e clicando em F5. Se tudo der certo, em 10 segundos você deverá ver esta mensagem:

Pronto! Conforme configuramos o OnTime para executar 10 segundos após a hora atual (linha 6) pois, Now retorna a data e hora atual e TimeValue(“00:00:10”) representa para o VBA 10 segundos, após executar a função TesteOnTime, ela programa a função ExecutaOnTime (linha 1) para ser executada neste tempo.

Para efeitos de teste, configure outros valores de tempo, mas tome o cuidado que sejam pequenos pois, se configurar para executar daqui a 24 horas (“24:00:00”), vai ter que esperar um bom tempo.

Para fazer outro teste interessante do OnTime, mude o código para ficar desta forma:

Public Sub ExecutaOnTime()
MsgBox "Opa!
Executou."
End Sub
Public Sub TesteOnTime()
Call Application.OnTime(TimeValue("13:00:00"),
"ExecutaOnTime")
End Sub

Da forma que está, o código irá configurar a função ExecutaOnTime (linha 1) para ser executada às na próxima 13:00 do computador em que está sendo executada. Como este é apenas um exemplo, configure uma hora que estiver mais próxima para não esperar muito.

É possível também cancelar a execução de uma macro agendada com o OnTime. O exemplo de código abaixo cancela a definição de OnTime do exemplo anterior, ou seja, caso a execução da função ExecutaOnTime estiver agendada, executar a função CancelaOnTime fará com que esta programação seja cancelada. isso é feito passando o valor False para o parâmetro Schedule (linha 10):

Public Sub</span> ExecutaOnTime()
MsgBox "Opa! Executou."
End Sub
Public Sub TesteOnTime()
Call Application.OnTime(TimeValue("13:00:00"),
"ExecutaOnTime")
End Sub
Public Sub</span> CancelaOnTime()
Call Application.OnTime(EarliestTime:=TimeValue("13:00:00"),
Procedure:="ExecutaOnTime", Schedule:=False)
End Sub

Conclusão

Com este recurso em mãos, é possível atender a algumas necessidades que no contexto do Excel pareciam inviáveis. Um exemplo típico é uma tela de apresentação ou SplashScreen como é conhecida que apresenta o programa e fecha em alguns segundos. Este é um bom teste para experimentar o uso do OnTime. Fica aí um desafio.

Excel – Gráfico de pizza dentro de outra pizza

Uma dica bem bacana postada pelo pessoal da INFO. A idéia é criar subgráficos, ou seja, gráficos que sejam filhos de um determinado conjunto de dados de um outro gráfico já existente, no estipo mestre-detalhe. Como construí-lo, veja a matéria abaixo. O teste foi realizado no Microsoft Excel 2003 e 2007.

Gráfico secundário pode ser usado no Excel para destacar a participação no conjunto de itens de menor valor
Gráfico secundário pode ser usado no Excel para destacar a participação no conjunto de itens de menor valor

Muitas vezes, alguns itens que compõem um gráfico de pizza têm uma participação tão reduzida na soma total que pode ser melhor passá-los para outro gráfico que consiga destacar melhor as pequenas contribuições. O Excel oferece dois tipos de gráfico que podem ser usados para esse fim: o Pizza de Pizza e o Coluna de Pizza. Para gerar o gráfico no Excel 2007, abra a guia Inserir > Pizza (menu Inserir > Gráfico > Pizza no Excel 2003). Escolha entre um dos dois tipos mencionados – o primeiro cria um novo gráfico de pizza ao lado do principal e o segundo gera uma barra, sendo que em ambas as representações os valores de cada item são distribuídos proporcionalmente.

Depois que o Excel gerar o gráfico, clique com o botão direito do mouse sobre ele, caso sinta necessidade de alterar o trabalho, e selecione a opção Formatar Série de Dados > Opções de Série (Formatar Série de Dados > Opções no Excel 2003). Na janela seguinte, em Dividir Série Em você poderá escolher quais fatias deverão ser exibidas no gráfico secundário, repartindo a série por Posição, Valor, Valor Percentual ou Personalizado. Em A Segunda Plotagem Contém… , que varia de acordo com o critério anteriormente escolhido, é possível definir o número de valores que serão exibidos. No gráfico de exemplo, dividimos a série em valor percentual e optamos por mostrar no segundo gráfico todos os valores inferiores a 3%.

Formatando a Série de Dados do Gráfico
Formatando a Série de Dados do Gráfico

VBA – Gráficos animados no Excel com VBA

Apesar de ser uma necessidade um tanto excêntrica, vale pelo aprendizado e inovação.

Os gráficos são ferramentas importantíssimas no Microsoft Excel. Os tipos são os mais variados e poder ser customizados a vontade. Só não é muito comum animá-los, como pode ser visto nestes exemplos:

http://www.ozgrid.com/forum/showthread.php?t=29991

http://spreadsheetpage.com/index.php/tip/animated_hypocycloid_charts/

Gráficos animados no Excel com VBA
Gráficos animados no Excel com VBA

O primeiro é um pouco mais simples, mas eficaz. Já o segundo consegue trazer um ar de Power Point. Muito bem bolado, além de ser um excelente exemplo e referência das capacidades de manipulação de gráficos no Excel. Nem preciso dizer que é preciso um bocado de VBA para a façanha.

Bom divertimento!

Tomás

VBA – Confirmando decisões com o MsgBox (VbMsgBoxResult)

Introdução

O VBA disponibiliza uma forma de emitir mensagens personalizadas para o usuário através da função MsgBox, permitindo incluse alterar uma série de suas configurações.

Desta vez, analisaremos uma das características da MsgBox que é analisar seu retorno, que é informado pelo usuário o clicar em um dos botões disponíveis na caixa de mensagem. este recurso é útil quando se deseja fazer questões aos usuários. A resposta da questão virá da opções oferecidas a ele pelo MsgBox.

Começaremos sabendo como analisar o retorno da MsgBox. Veja o código de exemplo:

1
2
3
4
5
Public Sub TesteMsgBox()
     Dim resultado As VbMsgBoxResult
     resultado = MsgBox("Testando o VbMsgBoxResult!", vbOKOnly, "Testando o MsgBox")
     MsgBox resultado
End Sub

O resultado da execução do código serão duas caixas de mensagem na seguinte sequência (clicando em OK em cada uma delas):

ajkbsmpbw67f_40cmg98f3c

ajkbsmpbw67f_41dh5q39fm

O que valor notar aqui é o seguinte. Pelo fato de termos informado o parâmetro Button como vbOkOnly, o único botão oferecido ao usuário foi o botão OK, o resultado não poderia sido outro que não um. Vamos relembrar a tabela de valores retornados pelo MsgBox:

Valores retornados

Constante Valor Descrição
vbOK 1 OK
vbCancel 2 Cancelar
vbAbort 3 Abortar
vbRetry 4 Repetir
vbIgnore 5 Ignorar
vbYes 6 Sim
vbNo 7 Não

Segundo a tabela, ao acionar o botão OK, o usuário está informando ao VBA um tipo de retorno com o valor 1 que correnpondente à contante vbOK. Vamos mudar o parâmetro Button para vbYesNo e verificar a execução do código:

1
2
3
4
5
Public Sub TesteMsgBox()
     Dim resultado As VbMsgBoxResult
     resultado = MsgBox("Testando o VbMsgBoxResult!", vbYesNo, "Testando o MsgBox")
     MsgBox resultado
End Sub

O resultado:

ajkbsmpbw67f_42dzkmn5cq

Note que mais opções foram oferecidas ao usuário. Agora clique no botão Sim para ver o que acontece com o retorno:

ajkbsmpbw67f_43gs3jr4gm

Na tabela de Valores retornado, podemos conferir que o valor 6 se refere à contante vbYes. Execute a função novamente, só que desta vez, clique na opção Não:

ajkbsmpbw67f_44d37tqtg4

Na tabela de Valores retornado, podemos conferir que o valor 7 se refere à contante vbNo.

Desta forma, conseguimos um meio que questionar o usuário e facilmente oferecer-lhe opções a respeito desta questão e analisar suas resposta. Experimente alterar o parâmetro Button da chamada ao MsgBox e veja o resultado informado.

Tornando o Recurso Útil

Vimos que é possível oferecer ao usuário uma série de alternativas de escolha em conjunto a uma mensagem com o MsgBox. Veremos agora um exemplo simples de como analisar o retorno da função MsgBox para tomar decisões nos aplicativos VBA.

Veja o seguinte trecho de código:

1
2
3
4
5
6
7
8
9
Public Sub TesteVbMsgBoxResult()
     Dim resultado As VbMsgBoxResult
     resultado = MsgBox("Tem certeza que deseja prosseguir com esta ação?", vbYesNo, "Tomando uma decisão")
     If resultado = vbYes Then
          MsgBox "Você acaba de confirmar a ação"
     Else
          MsgBox "Você acaba de recusar a ação"
     End If
End Sub

Veja que não é necessário gravar ou mesmo analisar o valor numérico do retorno do MsgBox. O VBA disponibiliza as constantes nomeadas, como vbYes, vbNo, vbOK para que seja possível fazer uma produção e leitura mais organizada do código.

Na linha 6, é declarada a variável resultado do tipo VbMsgBoxResult que armazenará o resultado da MsgBox. Na linha 4 acontece a chamada à MsgBox. Quando o usuária clicar em uma das opções mostrada, o VBA armazenará o retorno na variável resultado.

Em seguida, usa-se a estrutura If…Then…Else para avaliar o resultado da função. Veja que a comparação é feita com a contante vbYes. Como o código deseja confirmar a ação do usuário, este analisa o resultado de mostra a mensagem pertinente, Veja o resultado da execução do código:

ajkbsmpbw67f_45gzg6g4dv

Ao clicar no botão Sim, o seguinte resultado é mostrado:

ajkbsmpbw67f_46cwz3shhc

Como o resultado do MsgBox ao clicar no boatão sim é o valor de vbYes, o código executa a mensagem da linha 5.

Se executar o código novamente e clicar no botão Não, o resultado será:

ajkbsmpbw67f_47f7gc97fs

Desta vez, a linha executada pelo código foi a de número 7.

Com estes recursos, é possível oferecer o usuário praticamente todos os tipos de opção disponibilizados pelo Microsoft Windows em todas as situações. Você pode oferecer opções como Anular/Repetir/Ignorar, Sim/Não/Cancelar, entre outras.

Comentários

Vimos que o MsgBox oferece mais recurso além da simples exibição de mensagens. Tendo conhecimento de todos as possibilidades da função, você terá em mãos uma poderosa ferramenta para resolver praticamente todas as situações de decisçao que surgirem no desenvolvimento de seus aplicativos.