You are on page 1of 122

Excel Macros e Visual Basic for Applications

ndice

MACROS .......................................................................................................................................................5
O QUE UMA MACRO? .................................................................................................................................6
CRIAR MACROS ............................................................................................................................................6
Gravar uma Macro ..................................................................................................................................6
Exerccio .............................................................................................................................................................. 8
Procedimento BackGround do Excel ................................................................................................................... 9

Programao em Visual Basic for Applications....................................................................................10


EXECUTAR UMA MACRO ............................................................................................................................12
Tecla de Atalho Shortcut Key .............................................................................................................12
Boto na Toolbar...................................................................................................................................13
Associar uma Macro a um Boto ....................................................................................................................... 13
Dissociar uma Macro de um Boto .................................................................................................................... 15

Run ........................................................................................................................................................16
Comando no Menu ................................................................................................................................17
Associao de uma Macro a um Comando do Menu ......................................................................................... 17
Dissociao ........................................................................................................................................................ 19

Editor de Visual Basic for Applications ................................................................................................20


REMOVER MACROS ....................................................................................................................................21
Remoo de Macros em Ambiente Excel ...............................................................................................21
Remoo de Macros no Editor de VBA .................................................................................................21
EDITOR DE VISUAL BASIC FOR APPLICATIONS ...........................................................................22
PROJECT EXPLORER ...................................................................................................................................24
PROPERTIES WINDOW ................................................................................................................................26
JANELA DE EDIO ....................................................................................................................................27
OBJECT BROWSER ......................................................................................................................................28
HELP ON-LINE ...........................................................................................................................................28
AS CORES DO VBA ....................................................................................................................................29
FUNES E SUBROTINAS .....................................................................................................................30
SUBROTINAS ..............................................................................................................................................32
Definio de SubRotinas .......................................................................................................................32
Trabalhar no Editor de VBA Criar uma SubRotina ...........................................................................33
Execuo de uma SubRotina .................................................................................................................34
FUNES ....................................................................................................................................................34
Definio de Funes ............................................................................................................................34
Definio do tipo de parmetros e do tipo da funo ...........................................................................35
Trabalhar no Editor de VBA Criar uma Funo ................................................................................36
Execuo de uma Funo ......................................................................................................................37
Execuo dentro de uma Clula ......................................................................................................................... 38
Execuo dentro de uma Rotina......................................................................................................................... 40

DIFERENAS ENTRE FUNES E ROTINAS ..................................................................................................42


REGRAS PARA A PASSAGEM DE PARMETROS.............................................................................................42
VARIVEIS ................................................................................................................................................43
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
1 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


MANUSEAMENTO COM VARIVEIS .............................................................................................................43
O que so variveis? .............................................................................................................................44
Assignao de valores a variveis: .......................................................................................................44
Utilizao de variveis como se fossem valores: ..................................................................................45
TIPOS DE VARIVEIS...................................................................................................................................45
DECLARAO DE VARIVEIS .....................................................................................................................47
VARIVEIS VANTAGENS DA UTILIZAO ................................................................................................47
VARIVEIS DO TIPO OBJECTO ....................................................................................................................48
Declarao da Varivel Objecto ...........................................................................................................48
Atribuio de uma varivel Objecto ......................................................................................................48
Utilizao Genrica da Varivel Objecto .............................................................................................49
Utilizao Especifica da Varivel Objecto ............................................................................................49
VARIVEIS DECLARAO OPCIONAL E O TIPO VARIANT ........................................................................51
Os Prs e Contras da Utilizao do tipo Variants ................................................................................51
Prs .................................................................................................................................................................... 51
Contras ............................................................................................................................................................... 51

Variveis Declarao Forada ..........................................................................................................52


VARIVEIS TIPOS DEFINIDOS PELO UTILIZADOR - ESTRUTURAS ...............................................................53
Definio do Tipo ..................................................................................................................................53
Utilizao das Estruturas de Dados ......................................................................................................54
VARIVEIS ARRAYS ................................................................................................................................55
O que um Array ? ...............................................................................................................................55
Array Uni-Dimensional ..................................................................................................................................... 55
Array Bi-Dimensional........................................................................................................................................ 56

Declarao de um array ........................................................................................................................57


Arrays Uni-dimensionais ................................................................................................................................... 57
Arrays Bi-dimensionais ..................................................................................................................................... 57

Utilizao de um Array .........................................................................................................................58


Para aceder ao elemento ..................................................................................................................................... 58
Atribuio de valores ......................................................................................................................................... 58

Option Base e Array Bounds .................................................................................................................59


CONSTANTES ............................................................................................................................................60
O QUE SO CONSTANTES ? .........................................................................................................................61
INPUTBOX E MSGBOX............................................................................................................................62
O QUE SO ? ...............................................................................................................................................63
INPUTBOX ..................................................................................................................................................63
O que faz ............................................................................................................................................63
Sintaxe ...................................................................................................................................................63
Parmetros ............................................................................................................................................63
MSGBOX ....................................................................................................................................................65
O que faz ............................................................................................................................................65
Sintaxe ...................................................................................................................................................65
Parmetros ............................................................................................................................................66
Valores Produzidos ............................................................................................................................69
DOMNIO DAS VARIVEIS, CONSTANTES E ROTINAS ................................................................70
O QUE O DOMINIO? ..................................................................................................................................71
DOMNIO DAS VARIVEIS...........................................................................................................................71
mbito do Procedimento .......................................................................................................................72
mbito do Mdulo .................................................................................................................................73
mbito do Projecto ................................................................................................................................74
DOMNIO DAS CONSTANTES .......................................................................................................................75
mbito do Procedimento .......................................................................................................................75
mbito do Mdulo .................................................................................................................................76
mbito do Projecto ................................................................................................................................76
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
2 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


DOMNIO DE SUBROTINAS E FUNES .......................................................................................................77
ESTRUTURAS DE CONTROLO .............................................................................................................78
O QUE SO ESTRUTURAS DE CONTROLO? ...................................................................................................79
QUAIS AS ESTRUTURAS ..........................................................................................................................79
IF-THEN-ELSE ............................................................................................................................................80
Funo IF do Excel ...............................................................................................................................80
Sintaxe da Estrutura If-Then-Else .........................................................................................................80
Aplicao Prtica ..................................................................................................................................81
A instruo adicional ElseIf .................................................................................................................83
Aplicao Prtica ............................................................................................................................................... 83

FOR NEXT................................................................................................................................................84
Sintaxe ...................................................................................................................................................84
Aplicao Prtica ..................................................................................................................................84
A Funo das Variveis: .................................................................................................................................... 85
Construo do Ciclo:.......................................................................................................................................... 85
Traduo Integral ............................................................................................................................................... 86

Funcionamento do Ciclo: ......................................................................................................................86


Perigos associados utilizao do ciclo For-Next: ..............................................................................86
Outra Aplicao ....................................................................................................................................87
WHILE-WEND ............................................................................................................................................88
Sintaxe ...................................................................................................................................................88
Aplicao Prtica ..................................................................................................................................88
A Funo das Variveis: .................................................................................................................................... 89
Construo do Ciclo:.......................................................................................................................................... 89
Traduo Integral ............................................................................................................................................... 90

Funcionamento do Ciclo .......................................................................................................................90


Perigos associados utilizao do ciclo While-Wend ..........................................................................90
Outra Aplicao ....................................................................................................................................91
DO LOOP .................................................................................................................................................92
Sintaxe ...................................................................................................................................................92
Aplicaes Prticas ...............................................................................................................................92
SELECT CASE .............................................................................................................................................95
Sintaxe ...................................................................................................................................................95
Aplicao Prtica ..................................................................................................................................95
Construo da Estrutura ..................................................................................................................................... 96

FOR EACH NEXT ...................................................................................................................................98


Sintaxe ...................................................................................................................................................98
Aplicaes Prticas ...............................................................................................................................98
Utilizando Arrays ............................................................................................................................................... 99
Construo do Ciclo ...................................................................................................................................... 99
Utilizando Coleces de Objectos ................................................................................................................... 100

COLECES DE OBJECTOS E OBJECTOS .....................................................................................102


O QUE SO OBJECTOS ? ............................................................................................................................103
OBJECTOS: PROPRIEDADES, MTODOS E EVENTOS ..................................................................................103
Propriedades .......................................................................................................................................103
Mtodos ...............................................................................................................................................103
Eventos ................................................................................................................................................104
OBJECTOS MAIS UTILIZADOS NO EXCEL...................................................................................................105
Propriedades .................................................................................................................................................... 105
Mtodos ........................................................................................................................................................... 106
Propriedades .................................................................................................................................................... 107
Mtodos ........................................................................................................................................................... 108
Propriedades .................................................................................................................................................... 109
Mtodos ........................................................................................................................................................... 110
Propriedades .................................................................................................................................................... 111
Mtodos ........................................................................................................................................................... 112

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
3 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


OBJECTOS SINGULARES VS
COLECES DE OBJECTOS..................................................................113
INDEXAO DE COLECES POR NMERO OU NOME ................................................................................114
Indexao com Base em Nmeros .......................................................................................................114
Indexao com Base no Nome .............................................................................................................115
Vantagem ......................................................................................................................................................... 115

O Objecto Range uma excepo .......................................................................................................116


Tratamento como objecto: ............................................................................................................................... 116
Tratamento como coleco de objectos: .......................................................................................................... 116

REFERNCIA IMPLCITA............................................................................................................................117
Declarao implcita da aplicao: ....................................................................................................117
Declarao implcita do WorkBook: ...................................................................................................118
Declarao implcita da WorkSheet:...................................................................................................118
Nvel de referncia a privilegiar .........................................................................................................119
MISCELLANEOUS ..................................................................................................................................120
A INSTRUO WITH .................................................................................................................................121
Aplicao Prtica ................................................................................................................................121
OUTRAS FUNES TEIS DO VBA ...........................................................................................................121

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
4 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Macros

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
5 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

O QUE UMA MACRO?


Uma macro um pequeno programa que contm uma lista de instrues a realizar no
Excel. Como sendo um repositrio de operaes, uma macro pode executar um conjunto de
tarefas atravs de um nico procedimento o qual pode ser invocado rapidamente.
As instrues que formam o corpo da macro so escritas num cdigo prprio para que o
computador as possa entender, essa linguagem designada por VBA Visual Basic for
Applications.

CRIAR MACROS
Existem duas possibilidades de criao de macros:
Atravs do Gravador de Macros
Utilizando o editor e programando em Visual Basic for Applications

Gravar uma Macro


1. Tools / Macro / Record New Macro. O Excel exibir a caixa de dilogo da fig.1.

Fig.1 caixa de dilogo para a gravao de macros.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
6 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


2. O nome da Macro ser constitudo por um conjunto de caracteres que identificaro a
Macro e a sua funcionalidade.
3. Shortcut Key composto por uma combinao de teclas que podero ser utilizadas
para executar uma macro.
4. Opte por armazenar a macro numa das seguintes alternativas: This Workbook, New
Workbook ou Personal Workbook, sendo que cada uma corresponde a macros de
mbito diferente. Assim devero armazenar a macro na opo ThisWorkBook para que
ela esteja activa sempre que o documento estiver aberto, e para que ela esteja
armazenada no prprio ficheiro no correndo o risco de ficar armazenada nas Macros
do Excel. (na rede do ISCTE impossvel gravar a macro no Personal WorkBook.)
5. No campo Description, introduza um comentrio funo este poder ser importante
para que no seja esquecido o respectivo objectivo e funcionalidade.
6. Clique em OK para iniciar a gravao da macro neste momento ser exibida uma
toolbar semelhante da figura 2, e o cone do rato ser transformado numa cassete,
indicando o estado de gravao.

Fig.2 Toolbar exibida para a gravao de macros.

7. Na toolbar Stop Record, existem dois botes: Stop Recording e Relative Reference O
boto de Stop Recording termina a gravao da macro, o boto de Relative Reference
selecciona o modo de gravao da macro se feito com base em referncias relativas
(boto seleccionado) ou referncias absolutas.
8. No caso da toolbar Stop Record desaparecer, poder voltar a exibi-la fazendo no menu
a sequncia: View / Toolbars / Stop Record (seleccione a toolbar). Caso a toolbar no
aparea listada a gravao de macros no est activa.

Nota: Tome ateno aos passos que d quando est a gravar pois tudo ser registado, o que
significa que quando for executar a macro, esses procedimentos sero efectuados.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
7 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

EXERCCIO
Objectivo: Gravar uma macro testando a diferena entre a execuo de macros com
referncias absolutas e relativas.
1 Fase: Macro com referncias Absolutas
1.
2.
3.
4.
5.

Accione a gravao da macro. Atribua-lhe o Short Key Ctrl+P


Certifique-se que o boto Relative Reference est desactivado.
Clique na clula B3.
Escreva ISCTE
Formate a clula para Bold, Itlico, tamanho 18, Small Caps, (utilize o Format /
Font)
6. Na clula B4 escreva: Av. Foras Armadas
7. Na clula B5 escreva: 1700 Lisboa
8. Pare a gravao da macro. A macro est criada.
9. Apague tudo o que escreveu nas clulas da coluna B.
10. Clique na clula L8.
11. Carregue simultaneamente nas teclas Ctrl e P
12. O que aconteceu ?

2 Fase: Macro com referncias Relativas


1.
2.
3.
4.
5.

Seleccione a clula D5.


Accione a gravao da macro. Atribua-lhe o Short Key Ctrl+R
Seleccione o boto Relative Reference.
Escreva ISCTE na clula que havia sido seleccionada.
Formate a clula para Bold, Itlico, tamanho 18, Small Caps, (utilize o Format /
Font)
6. Na clula D6 escreva: Av. Foras Armadas
7. Na clula D7 escreva: 1700 Lisboa
8. Pare a gravao da macro. A macro est criada.
9. Apague tudo o que escreveu nas clulas da coluna D.
10. Clique na clula L8.
11. Carregue simultaneamente nas teclas Ctrl e R
12. O que aconteceu ? Porqu ?

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
8 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

PROCEDIMENTO BACKGROUND DO EXCEL


O Excel quando se grava uma macro cria um objecto designado por module no workbook
onde regista todas as operaes gravadas em linguagem Visual Basic for Applications VBA. Este module no aparece no Excel com as restantes Sheets.
Para ser visualizado necessrio abrir o Editor de Visual Basic for Applications:
1. Tools / Macro / Macros
2. Selecciona-se a Macro e Clica-se no boto Edit
3. Poder visualizar na rea do lado direito o cdigo VBA que est subjacente s macros
que entretanto gravou. A poder executar as mesmas tarefas que num editor de texto
normal: escrever, apagar, copiar, mover, mas instrues de VBA.
4. Tente fazer a leitura do que est escrito e compreenda o procedimento da macro.
5. Para regressar ao Excel basta File / Close and return to Microsoft Excel.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
9 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Programao em Visual Basic for Applications


1. Para aceder ao editor de Visual Basic for Applications: Tools / Macro / Visual Basic
Editor (para se familiarizar mais com o editor consulte o capitulo Editor Visual Basic
for Applications e o capitulo Funes e SubRotinas)

Figura 3 Editor de Visual Basic for Applications

2. Para inserir um mdulo faa Insert / Module isto porque as macros que construir
devero ser escritas dentro de um mdulo (repare na Figura 3 que o Module 1 est
seleccionado na janela de projecto e do lado direito tem-se uma rea de edio onde
poder-se-o escrever as macros a executar)

3. Pode agora programar os procedimentos manualmente ou com recurso a algumas


funcionalidades do Editor:
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
10 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


a) Insert / Procedure insere um procedimento para o qual dever indicar o tipo de
procedimento.
b) Quando estiver a introduzir as variveis haver de ser exibida a lista de tipos de
variveis possvel.
4. Sempre que precisar de construir uma macro mais ou menos complicada, se no
conhecer muito de VBA poder comear por gravar no EXCEL pequenas macros com
operaes muito simples e depois no editor de VBA tentar compreender a sua
funcionalidade e assim construir uma macro cada vez mais complexa, completa e
adequada s suas exigncias.
5. Poder em cada macro fazer uma chamada a uma outra macro, bastando para tal
escrever o respectivo nome.
6. No Editor de Visual Basic for Applications poder encontrar ajuda para o
desenvolvimento do seu procedimento. Assim:

6.1. Clique no cone do Object Browser ou View/Object Browser ou F2


6.2. Na Caixa de Drop-Down onde aparece referido <All Libraries>, seleccione a
aplicao para a qual pretende ajuda neste caso Excel. Convm referir que poder
utilizar as funes de toda e qualquer aplicao.
6.3. Na rea intitulada por Classes aparecem todos os objectos especficos para o
manuseamento da aplicao seleccionada. A classe especial designada por Globals
refere-se s funes que esto disponveis na aplicao independentemente dos
objectos seleccionados.
6.4. Seleccione um dos objectos e visualize do lado direito os Members of <Elemento
seleccionado>

6.5. Para cada membro da classe dispe de um help on-line que o esclarece sobre a
respectiva funo e funcionamento, dando exemplo que poder testar. Para tal basta
clicar sobre o boto de Help da janela do Object Browser.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
11 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

EXECUTAR UMA MACRO


A execuo de uma macro pode ser concretizada de diversas formas:

Tecla de Atalho Shortcut Key


Boto na Toolbar
Run
Comando no Menu
Editor de Visual Basic for Applications

Tecla de Atalho Shortcut Key


A associao a teclas de atalho realizada aquando da criao da macro.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
12 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Boto na Toolbar

ASSOCIAR UMA MACRO A UM BOTO


1. View / Toolbars / Customize
2. Na janela do Customize seleccione o Commands Tab
3. Seleccione a categoria Macro (visualizar a caixa de dilogo exibida na Figura 4)

Fig.4 caixa de dilogo para assignao de boto a macros

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
13 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


4. Na rea respeitante aos Commands sero exibidos dois itens: Custom Menu Item e
Custom Button. Seleccione este segundo e arraste-o com o rato at Toolbar onde o
pretende inserir. Ateno s poder inserir o boto quando o ponteiro do rato ficar com a
forma I. Nesse momento libertar o boto do rato utilizado para o arrastamento e
verificar que ser criado um novo boto.

5. Na janela de Customize poder ainda utilizar dois botes que se encontram na rea do
Selected Command:
a) Description que exibe um texto explicando o que o comando seleccionado faz.
b) Modify Selection semelhante ao clique sobre o boto criado, exibe uma srie
de tarefas possveis para configurao do boto ( ver operaes seguintes).

Fig.5 Menu para configurao do boto da toolbar

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
14 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


6. Clique sobre o boto Modify Selection- abrindo um menu de tarefas possveis para a
configurao do boto Ver Figura 5
a) No ltimo agrupamento de configuraes possveis existe uma opo designada
por Assign Macro. Esta opo permite indicar qual a macro que dever ser
executada sempre que se clica no boto.
b) No terceiro agrupamento existem 4 estilos diferentes de exibir o boto: s com
texto, com texto e imagem ou somente com imagem. Se seleccionar o estilo
Texto e Imagem, ser exibido no boto para alm da imagem o nome associado
ao boto.
c) Na opo Name indique o nome que pretende ver associado ao boto, por defeito
aparece o nome da macro. (repare que aparece um & atrs da letra que aparece a
sublinhado)
d) Para alterar a imagem associada ao boto poder: optar por uma imagem
diferente, alterar a que est a visualizar ou a construir a sua. Para isso clique
sobre a tarefa de Change Button Image, seleccione o logotipo pretendido, se
nenhum o satisfizer e pretender criar o seu seleccione o logotipo que representa
um quadrado vazio. Para o poder (re)desenhar a imagem, na lista de tarefas
disponibilizada pelo boto Modify Selection opte por Edit Button Image e crie a
sua imagem que poder reeditar.

DISSOCIAR UMA MACRO DE UM BOTO


1. Tools / Customize
2. Arraste o boto da toolbar at ao documento
3. Solte-o

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
15 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Run
1. Tools / Macro / Macros
2. Na caixa de dilogo Macros selecciona-se a macro pretendida na lista da Macro Name
(Figura 6)
3. Clique sobre o boto Run

Fig.6 Janela para seleco da macro a executar

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
16 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Comando no Menu

ASSOCIAO DE UMA MACRO A UM COMANDO DO


MENU
1. View / Toolbars / Customize
2. Na janela do Customize encontra-se no Commands Tab
3. Seleccione a categoria Macro
4. Na area respeitante aos Commands ser exibido um item de Custom Menu Item,
seleccione-o e arraste-o com o rato at a uma posio do menu que lhe interesse por
exemplo pode introduzir numa das listas de opes do menu (File, View,) ou ento
criar como uma nova opo do Menu..

Fig.7 Caixa de dilogo para atribuir uma macro a um comando do menu

5. Se pretender criar uma nova lista no menu dever :


______________________________________________________________________________________L
EANDRO ALVES FERREIRA
17 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

a) Seleccionar a categoria New Menu


b) Na rea dos Commands ser exibida a opo New Menu, que dever arrastar at
barra dos menus
c) Poder alterar o seu nome clicando no boto de Modify Selection
d) Esta nova lista ter o mesmo comportamento que a outras

Fig.8 Caixa de dilogo para criar um novo menu na barra dos menus

6. Na janela de Customize poder ainda utilizar dois botes que se encontram na rea do
Selected Command:
c) Description que exibe um texto explicando o que o comando seleccionado faz.
d) Modify Selection semelhante ao clique sobre o menu ou comando de menu
criado, exibe uma srie de tarefas possveis para configurao (Ver o item 6 do
captulo Associar uma Macro a um Boto)

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
18 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

DISSOCIAO
1. Tools / Customize
2. Arraste o Menu ou Comando do Menu at ao documento e solte-o

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
19 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Editor de Visual Basic for Applications


1. Tools / Macro / Visual Basic Editor - para aceder ao Editor
2. Posicionando-se no corpo de uma macro, na janela do lado direito inferior, poder
executar a macro atravs de: Run / Run Sub-UserForms (figura 9) ou boto Run.

Fig.9 Execuo de uma macro no Editor de Visual Basic for Applications

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
20 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

REMOVER MACROS
A remoo das macros poder ser feita:
no ambiente Excel, ou
no Editor de VBA

Remoo de Macros em Ambiente Excel


1. Tools / Macro / Macros
2. Selecciona-se a Macro a remover
3. Clica-se no boto Delete
4. Pede a confirmao e apaga se confirmar

Remoo de Macros no Editor de VBA


2. Tools / Macro / Visual Basic Editor - para aceder ao Editor
3. Podem-se apagar as macros que se encontrem na janela do lado direito inferior e que
tm inicio com a palavra Sub e fim com as palavras End Sub (Ver capitulo de funes e
procedimentos)

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
21 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Editor de Visual
Basic for
Applications

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
22 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Para aceder ao editor de Visual Basic for Applications: Tools / Macro / Visual Basic Editor

Figura 10 Editor de Visual Basic for Applications

Encontrar o cran dividido em trs grandes reas: Project Explorer, Properties Window e
do lado direito a janela de edio de texto.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
23 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

PROJECT EXPLORER
Se a janela no estiver visvel active-a atravs do View / Project Explorer ou utilizando o
boto ou combinaes de letras associadas a esta tarefa.
Nesta janela poder visualizar a hierarquia dos projectos de Visual Basic for Applications
activos nesse momento.
Entre eles dever encontrar um cujo nome corresponde ao nome do WorkBook do Excel
com que est a trabalhar. E.g. VBAProject (Book1). dentro deste projecto que dever
trabalhar para que todas as funcionalidades que implemente estejam nele activas sempre
que necessrio.

Figura 11 Janela do Project Explorer

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
24 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Assim se fizer o desdobramento do seu VBAProject, encontrar um folder cuja designao


Microsoft Excel Objects, e um outro designado Modules (se este no aparecer significa
que o seu projecto ainda no possui qualquer macro implementada. Para criar este folder
dever fazer: Insert / Module).
No folder do Microsoft Excel Objects, encontrar todos os objectos que fazem parte do seu
documento: as WorkSheets e o WorkBook (que no fundo o conjunto de WorkSheets). Se
clicar duplamente em cada um destes objectos, uma nova janela ser visualizada na rea da
direita, em cada uma dessas reas poder definir a aco a ser executada em funo dos
eventos de cada objecto.
No Folder Modules, aparecer o conjunto de ficheiros (mdulos) onde poder programar as
suas macros. Clicando duplamente em cada um dos mdulos indicados poder visualizar as
macros, que o compem, na janela da direita.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
25 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

PROPERTIES WINDOW
Se a janela das propriedades no estiver visvel active-a atravs do View / Properties
Window ou utilizando o boto ou combinaes de letras associadas a esta tarefa.

Figura 12 Janela de propriedades

Nesta janela poder visualizar e alterar as propriedades que definem cada objecto: o nome neste caso.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
26 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

JANELA DE EDIO
A janela de edio exibir a cada momento o cdigo em Visual Basic for Applications
associado ao elemento seleccionado na janela do Project Explorer.

Figura 13 Janela de edio

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
27 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

OBJECT BROWSER
No Editor de Visual Basic for Applications poder encontrar ajuda para o desenvolvimento
do seu procedimento. Assim:
Clique no cone do Object Browser ou View/Object Browser ou F2
Na Caixa de Drop-Down onde aparece referido <All Libraries>, seleccione a aplicao
para a qual pretende ajuda neste caso Excel. Convm referir que poder utilizar as
funes de toda e qualquer aplicao.
Na rea intitulada por Classes aparecem todos os objectos especficos para o
manuseamento da aplicao seleccionada. A classe especial designada por Globals
refere-se s funes que esto disponveis na aplicao independentemente dos objectos
seleccionados.
Seleccione um dos objectos e visualize do lado direito os Members of <Elemento
seleccionado>
Para cada membro da classe dispe de um help on-line que o esclarece sobre a
respectiva funo e funcionamento, dando um exemplo que poder testar. Para tal basta
clicar sobre o boto de Help da janela do Object Browser.

HELP ON-LINE
O Editor de Visual Basic for Applications, disponibiliza ao utilizador um sistema de ajuda
constante. Assim, quando se constroiem procedimentos, na janela de edio, medida que
a linguagem escrita o editor abre oportunamente listas de opes para ajudar a escrever o
cdigo.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
28 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

AS CORES DO VBA
Na Janela de Edio so programados, armazenados e exibidos os procedimentos VBA
criados.
Porm, o texto envolvido em cada procedimento dotado de uma srie de cores diferentes,
sendo que cada uma tem significado diferente.

Cor

Significado

Azul

Palavras-Chave da linguagem. Ex: Sub, End Sub, Function, If, Then,


Else, While, Loop,

Vermelho

Sempre que escreve na janela uma linha em linguagem VBA, o editor


vai rectificar a sintaxe da linguagem por forma a indicar se existe ou
no algum erro de escrita. Se for detectado um erro a linha fica a
vermelho e exibida uma mensagem de erro, seno todas as palavras
so reconhecidas, coloridas da cor da respectiva categoria e alteradas
para letras maisculas ou minsculas, conforme esteja pr-definido.

Preto

Nome de variveis, procedimentos, valores, operadores,

Verde

Comentrio introduzidos no seio dos procedimentos. Estes


comentrios servem para o utilizador poder associar algumas
explicaes aos procedimentos realizados. De referir que as palavras
com esta cor so ignoradas no procedimento, i.e., no produzem
qualquer efeito na sua execuo. Para introduzir comentrios bastar
que o caractere anteceda o texto a introduzir.

Amarelo

Um sombreado amarelo poder aparecer sobre a linha que identifica


um procedimento. Esta cor simboliza a ocorrncia de um erro na
execuo do respectivo procedimento e o estado de execuo do
mesmo, i.e., o procedimento iniciou a execuo, durante a qual
detectou um erro e agora est parado, mas ainda em execuo.
Quando isto acontecer no dever voltar a dar ordem de execuo do
procedimento, sem antes parar (Stop) a execuo mal sucedida.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
29 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Funes e
SubRotinas

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
30 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


Como foi referido anteriormente, quando se grava uma macro no Excel, este tem um
comportamento em background que realiza a respectiva codificao para Visual Basic for
Applications. Este resultado bem visvel quando procedemos edio de uma macro no
Editor de Visual Basic for Applications. Cada macro que se cria tem um comportamento
concreto e autnomo relativamente a outras macros implementadas, e tem como objectivo
executar um determinado nmero de instrues1 que respondam s exigncias do utilizador.
Cada macro criada d origem a um procedimento ou rotina. Existem dois tipos de rotinas:
as subrotinas ou rotinas Sub, e
as funes.

Entenda-se instruo como uma tarefa a executar que corresponde a uma linha de cdigo.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
31 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

SUBROTINAS
Definio de SubRotinas
As SubRotinas so aquelas cuja definio delimitada pelas palavras-chave Sub e EndSub.
Assim se reparar todas as macros que grava no Excel so deste tipo. Repare ainda como
que so definidas:
Sub <nome_da_macro> ( )
<corpo_da_macro>
End Sub
Estas SubRotinas so designadas pelo nome2 que lhe atribumos e no recebem parmetros3
do exterior, tm como funo desempenhar um conjunto de tarefas que compem o seu
corpo. O corpo da macro, assim composto por um conjunto de instrues, sendo que cada
instruo diferente necessita de estar numa linha diferente. Contudo, quando se trata de
instrues demasiado grandes o editor faz a sua partio por diversas linhas, recorrendo ao
operador _, por forma a facilitar a leitura.

O nome da rotina pode ser qualquer um desde que no contenha espaos, comece por caracteres alfa

Para ter a noo do que so parmetros recorde-se do funcionamento das funes do Excel, que para
executarem determinada funo necessitavam de receber parmetros que colocamos entre parntesis
separados por virgulas.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
32 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Trabalhar no Editor de VBA Criar uma SubRotina


Para criar uma SubRotina necessrio que exista um mdulo onde se possa escrever.
Uma vez posicionado nesse mdulo poder:
Escrever a macro integralmente, ou
Recorrer ao Insert / Procedure para que o Visual Basic for Applications lhe crie a
estrutura (Figura 14)

Figura 14 Caixa de Dilogo para a criao de uma nova rotina

Assim dever indicar o tipo de rotina a criar Sub e o nome que pretende dar
macro (ou rotina ou procedimento ou SubRotina) 4. Automaticamente ele criar a
estrutura da rotina, neste caso ficaria:
Sub Macro1( )
End Sub

Nomes alternativos para fazer referncia a um conjunto de instrues.


______________________________________________________________________________________L
EANDRO ALVES FERREIRA
33 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Execuo de uma SubRotina


SubRotina e Macro so duas designaes para a mesma realidade, portanto tudo o que foi
referido relativamente a Macros vlido tambm para as SubRotinas. (Consultar captulo
das Macros)
Neste contexto a execuo de SubRotinas segue o mesmo mecanismo das macros. Porm
neste momento j se pode referir uma nova forma de executar as macros ou SubRotinas
dentro de outras rotinas, i.e., quando se escreve dentro de uma rotina o nome de outra a
execuo da rotina tem continuidade na execuo da rotina que est a ser invocada.

FUNES
Definio de Funes
Funes so rotinas cuja definio comea com a palavra-chave Function e termina com as
palavras End Function. Todas as funes que utiliza no Excel so deste tipo de rotina. A
sua definio tem a estrutura seguinte:
Function <Nome da Funo> ( <parametro1>, <parametro2>,)

<Nome da Funo> = <Valor / Expresso>

End Function
A funo identificada pelo nome, pelo nmero e tipo de parmetros recebidos, e tem
como objectivo executar um conjunto de instrues e produzir um valor final. Isto ,
sempre que se pretender executar uma funo sabido priori que ela produzir um valor.
Recorde-se como exemplo a funo SUM, esta recebe por parmetro um conjunto de
valores que se pretendem somar, sabe-se que o resultado da aplicao dessa funo ao
conjunto de valores ser o respectivo somatrio.
Para definir o valor produzido por uma funo basta no seu interior, atribuir ao nome da
funo um determinado valor ou expresso.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
34 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Definio do tipo de parmetros e do tipo da funo


Todos os elementos de input e output de uma funo tm um tipo de dados atribudo.
Assim os parmetros devero ser definidos com o tipo de dados respectivo e a funo
dever ser definida do tipo de dados que ela envie para o exterior.
Aps isto poder-se- refinar a definio de uma funo:
Function <Nome da Funo> ( <parametro1> As <Tipo>, ) As <Tipo>

<Nome da Funo> = <Valor / Expresso>

End Function

Nota: Se os tipos no forem definidos ser assumido por defeito como sendo do tipo
Variant

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
35 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Trabalhar no Editor de VBA Criar uma Funo


Para criar uma Funo necessrio que exista um modulo onde se possa escrever.
Uma vez posicionado nesse mdulo poder:
Escrever a macro integralmente, ou
Recorrer ao Insert / Procedure para que o Visual Basic for Applications lhe crie a
estrutura (Figura 15)

Figura 15 Caixa de Dilogo para a criao de uma nova rotina - funo

Nesta caixa de dilogo dever indicar o tipo de rotina a criar Function e o nome
que pretende dar funo. Automaticamente o Visual Basic for Applications criar
a estrutura da rotina, que neste caso ficaria:

Function IVA( )
End Function

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
36 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Execuo de uma Funo


Uma vez que uma funo produz um valor ela poder ser executada:
dentro de uma clula numa WorkSheet, semelhana de qualquer uma outra funo do
Excel
dentro de qualquer outra funo ou SubRotina.

Com base na seguinte funo, analisemos as formas de execuo com mais pormenor:

Figura 16 Janela de Edio com a funo IVA

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
37 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

EXECUO DENTRO DE UMA CLULA


1. Posicione-se na clula onde pretende inserir a funo
2. Insert / Function
3. Seleccione a categoria User Defined repare que aparece listada a funo que acabou
de criar IVA (Figura 17)

Figura 17 Caixa de Dilogo para introduo da funo

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
38 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

4. Clique em OK e de imediato uma janela de ajuda vir auxiliar a utilizao da sua


funo (Figura 18)

Figura 18 Caixa de Dilogo para apoio utilizao da funo

5. Introduza os parmetros e clique em OK (Figura 19)

Figura 19 Caixa de Dilogo para apoio utilizao da funo introduo de valores

Em suma:
Qualquer funo poder ser chamada a partir da WorkSheet do Excel, sendo que a sua
chamada ser realizada semelhana de qualquer outra funo: numa clula
= <nome da funo> (<Param_1> , <Param_2>)

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
39 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

EXECUO DENTRO DE UMA ROTINA


Quando dentro de uma rotina se faz referncia ao nome de uma outra rotina a execuo da
primeira passa pela execuo daquela que est a ser invocada.
No exemplo que se segue, a funo Valor_Liquido faz uma chamada funo IVA por
forma a que, o valor por esta produzido, seja adicionado varivel Valor, e assim produzir
o output final da funo Valor_Liquido.

Figura 20 Funo Valor_Liquido ao ser executada d ordens de execuo funo IVA

Um outro exemplo poder elucidar melhor:


______________________________________________________________________________________L
EANDRO ALVES FERREIRA
40 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Figura 21 A Subrotina Ident_Maior ao ser executada d ordens de execuo funo Ver_Maior

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
41 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

DIFERENAS ENTRE FUNES E ROTINAS


As funes so similares s subrotinas, existem simplesmente trs diferenas:
1. As Funes Comeam com a palavra-chave Function e terminam com as palavras End
Function
2. As Funes podem ser chamadas a partir de frmulas introduzidas numa WorkSheet
3. As funes retornam valores para as frmulas ou subrotinas que as chamarem

REGRAS PARA A PASSAGEM DE PARMETROS


Regra 1: Como uma funo retorna um valor, esta dever ser utilizada numa expresso.
Quando uma funo utilizada do lado direito de uma assignao, ou como argumento de
uma outra rotina, dever-se- passar os parmetros dentro de parntesis
Regra 2: Pode-se chamar uma funo ou subrotina com a palavra-chave Call, neste caso
dever-se-o colocar todos os parmetros entre parntesis.
Regra 3: Quando uma rotina chamada de forma isolada e sem a palavra-chave Call, no
se deve utilizar parntesis.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
42 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Variveis

MANUSEAMENTO COM VARIVEIS


______________________________________________________________________________________L
EANDRO ALVES FERREIRA
43 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

O que so variveis?
As variveis constituem repositrios temporrios de dados, podendo ser utilizadas para
diversos fins.

Figura 22 Manuseamento de Variveis

Assignao de valores a variveis:


______________________________________________________________________________________L
EANDRO ALVES FERREIRA
44 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


Quando se pretende atribuir valores a variveis dever-se- indicar o nome da varivel, o
operador "=" e o valor que se pretende que a varivel armazene.
<Nome_Varivel> = <Valor>
Pela observao do procedimento Adio - Figura 22- podemos verificar que as variveis
Parcela_1 e Parcela_2 armazenam os valores introduzidos pelo utilizador atravs das
InputBox (Ver captulo "InputBox e MsgBox"). Tambm varivel Total vai ser atribudo o
valor resultante da adio das duas parcelas - Total = Parcela_1 + Parcela_2.

Utilizao de variveis como se fossem valores:


O nome da varivel representa o contedo da mesma, i.e., sempre que mencionar o nome
da varivel o seu contedo que ser considerado.
No exemplo da figura 22, pode-se constatar que na expresso:
Total = Parcela_1 + Parcela_2
Parcela_1 representa o primeiro valor introduzido e Parcela_2 representa o segundo valor,
no se trata de adicionar o nome de duas variveis, mas adicionar os contedos que elas
armazenam.

TIPOS DE VARIVEIS
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
45 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


O tipo de varivel est associado ao gnero de informao que esta tem hiptese de
armazenar
Boolean 2 bytes Permite armazenar valores Boolenaos True ou False
Byte 1 Byte permite armazenar nmeros sem sinal entre 0 e 255
Currency - 8 bytes permite armazenar moeda
Date 8 Bytes permite armazenar datas
Double 8 bytes permite armazenar um real desde -1.79769313486232E308 at 4.94065645841247E-324 para valores negativos, e desde 1.79769313486232E308
at 4.94065645841247E-324 para valores positivos.
Single 4 bytes permite armazenar um real desde -3.402823E38 at
-1.4011298E-45, para valores negativos e desde 3.402823E38 at
1.4011298E-45, para valores positivos
Integer 2 bytes - permite armazenar nmeros inteiros entre -32.768 e 32767
Long 4 bytes permite armazenar nmeros inteiros entre -2 147 483 648 e
2 147 483 648
Object 4 bytes utilizado para fazer referncia a um objecto do Excel
String 1 byte por caractere permite armazenar conjuntos de caracteres
Variant 16 bytes - permite armazenar qualquer tipo de dados
User-Defined permite armazenar valores de tipos diferentes

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
46 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

DECLARAO DE VARIVEIS
Dim I_Numero As Integer
Onde:
Dim Palavra chave que indica uma declarao de variveis (abreviatura de dimenso)
I_Numero - nome da varivel a utilizar
As palavra chave utilizada para separar o nome da varivel do tipo de dados
Integer tipo de dados atribudo varivel

possvel na mesma declarao de variveis declarar variveis de diversos tipos:

Dim var1 As Integer, var2 As Date, var3 As Double


Para declarar diversas variveis do mesmo tipo:

Dim var_1, var_2, var_3 As Currency

VARIVEIS VANTAGENS DA UTILIZAO


Simplificam a codificao, principalmente quando se necessita de utilizar um valor
especifico inmeras vezes
Com variveis o cdigo mais rpido

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
47 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

VARIVEIS DO TIPO OBJECTO


Uma varivel objecto representa uma referncia a um objecto. Uma varivel de extrema
importncia que facilita a codificao e melhora a performance da subrotina.

Declarao da Varivel Objecto


Dim <Var_Objecto> As Object

Atribuio de uma varivel Objecto


Set <Var_Objecto> = <Objecto>

Onde:
Set palavra chave que indica a assignao de uma varivel objecto
<Var_Objecto> - Varivel Objecto
= - Operador de assignao
<Objecto> - Objecto a ser atribudo varivel

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
48 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Utilizao Genrica da Varivel Objecto


A utilizao genrica do tipo Objecto serve para suportar qualquer tipo de objecto Excel
(WorkBook,WorkSheet,Range,)
Exemplo:
Dim Range_1 as Object
Range_1 = Worksheet(1).Range(A1)
Range_1.Value = 10

Utilizao Especifica da Varivel Objecto


Utiliza-se o tipo exacto do objecto que se pretende atribuir varivel. Esse tipo especifico
de objectos coincide com o nome dos objectos em EXCEL.
Dim Range_1 As Range
Dim WB_1 As Workbook
Dim WS_1 As WorkSheet
Dim XL As Aplicativo

Exemplo:
Dim Range_1 as Range
Range_1 = Worksheet(1).Range(A1)
Range_1.Value = 10

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
49 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


Contudo estas declaraes tambm podem ser feitas da seguinte forma genrica:
Dim Range_1 As Object
Dim WB_1 As Object
Dim WS_1 As Object
Dim XL As Object

Ento qual o interesse de definir as variveis de forma especifica se o


podemos fazer de forma genrica?
Por uma questo de performance, se utilizar um objecto genrico, o VBA antes de executar
qualquer funo com o objecto tem que primeiramente o identificar (perdendo tempo) em
subrotinas simples essa diferena no substancial mas quando se trata de grandes
subrotinas j se denotam diferenas significativas.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
50 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

VARIVEIS DECLARAO OPCIONAL E O


TIPO VARIANT
A declarao de variveis opcional, se as variveis no forem declaradas o VBA faz a sua
declarao por defeito. Assim sempre que a instruo do Dim omitida para uma varivel,
essa assume o tipo Variant.

Os Prs e Contras da Utilizao do tipo Variants

PRS

Diminui o nmero de linhas de cdigo

No necessrio estar preocupado se a varivel est ou no declarada porque o VBA


automaticamente o faz

CONTRAS

Aumenta o tempo de execuo o VBA primeiro precisa de reconhecer o tipo de dados


com os quais est a trabalhar.

Este tipo de dados consome mais memria (uma vez que tem que alocar espao para
qualquer tipo de dados que lhe seja atribudo) 16 bytes mais um byte por caractere se
for String => problemas de performance para subrotinas grandes.

No possvel saber o tipo de dados que uma determinada varivel contm


dificultando a deteco de erros.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
51 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Variveis Declarao Forada


Para que o VBA detecte um erro sempre que uma varivel no seja declarada dever fazer:

Tools/Options
Editor Tab
Activar Require Variable Declaration

Ou ento, escrever no incio de cada mdulo Option Explicit


Neste caso sempre que seja detectada uma varivel que ainda no foi declarada d uma
mensagem de erro - Variable Not Defined

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
52 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

VARIVEIS TIPOS DEFINIDOS PELO


UTILIZADOR - ESTRUTURAS
Definio do Tipo
A primeira fase constituda pela definio do tipo:

Type Dados_Pessoais
Nome As String
Idade As Integer
DataNascimento As Date
BI As Long
End Type
Criou-se um tipo de dados que representa uma estrutura com dados de diferentes tipos. Esta
definio dever ocorrer no incio do mdulo VBA.

Onde:
Type

Palavra-Chave que indica a definio de um tipo de


dados criado pelo utilizador.

Dados_Pessoais

Nome atribudo ao tipo de dados.

Nome As String

Primeiro elemento da estrutura de dados definida.

Idade As Integer

Segundo elemento da estrutura de dados definida.

DataNascimento As Date

Terceiro elemento da estrutura de dados definida.

BI As Long

Quarto elemento da estrutura de dados definida.

End Type

Palavra-Chave que indica o fim da definio da


estrutura de dados.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
53 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Utilizao das Estruturas de Dados


Como utilizar as estruturas de dados:
Sub Tipos_definidos_Utilizador()
Dim Pessoa As Dados_Pessoais
Pessoa.Nome = Francisco
Pessoa.DataNascimento = #8/7/73#
Pessoa.Idade = WorksheetFunction.Year(Date)_
WorksheetFunction.Year(Pessoa.DataNascimento)
Pessoa.BI = 103582915
MsgBox 5Pessoa.Nome & Chr(13) & , Idade & Pessoa.Idade & Chr(13) & _
, Data de Nascimento & Pessoa.DataNascimento & Chr(13) & _
, com o BI nmero _ & Pessoa.BI
End Sub

Ver captulo InputBox e MsgBox


______________________________________________________________________________________L
EANDRO ALVES FERREIRA
54 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

VARIVEIS ARRAYS
O que um Array ?
Um Array uma varivel que representa um conjunto de variveis do mesmo tipo.
Os Arrays podem ser multi-dimensionais, onde todas as dimenses so indexadas
numericamente.

ARRAY UNI-DIMENSIONAL
0
1
2
3
4
5

Um array uni-dimensional constitudo por uma nica lista de elementos indexveis. Esta
lista tem um elemento inicial e um outro final sendo que a cada elemento da lista
corresponde um nico ndice, traduo do lugar que ocupa na lista, que o identifica
univocamente.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
55 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

ARRAY BI-DIMENSIONAL
0

2
0
1
2
3

Um array bi-dimensional um pouco mais complexo e constitudo por um conjunto de


listas do mesmo comprimento, este formato normalmente conhecido como array ou
matriz. portanto constituda por linhas e colunas e cada elemento identificado por um
ndice composto pela intercepo dos nmeros da linha e da coluna.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
56 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Declarao de um array

ARRAYS UNI-DIMENSIONAIS
Dim ArrayNumerico(10) As Integer
Array_Numerico o nome da varivel array, o nmero entre parntesis indica o nmero de
elementos que o array pode armazenar, isto
Array_Numerico
0
1
2
3
4
5
6
7
8
9
Em que cada elemento do tipo Integer.

ARRAYS BI-DIMENSIONAIS
Dim Tabela_Textual (5, 4 ) As String
Tabela_textual o nome da varivel, os nmero entre parntesis indicam que a tabela ir ter
5 linhas e 4 colunas, podendo assim armazenar 20 elementos do tipo String.
Tabela_Textual
0

2
0
1
2
3

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
57 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Utilizao de um Array

PARA ACEDER AO ELEMENTO


<Nome_do_Array>(<Indice1_do_Elemento>[,<Indice2_do_Elemento>, ])

ATRIBUIO DE VALORES
<Nome_do_Array>(<Indice1_do_Elemento>[,<Indice2_do_Elemento>, ]) = <Valor>

Exemplo 1:
Sub Pases()
Dim Pases(3) As String
Pases (0) = "Portugal"
Pases(1) = "Brasil"
Pases(2) = "Moambique"
MsgBox "Pases Armazenados:" & Chr(13) & Pases(0) & Chr(13) & Pases(1) &_ Chr(13)
& Pases(2)
End Sub

Aps a atribuio de valores a cada elemento do array, este passa a ter o contedo seguinte:
Pases
Portugal
Brasil
Moambique

0
1
2

Valor estes que sero exibidos atravs da MsgBox.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
58 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Exemplo 2:
Option Base 1
Sub Utilizacao_Array()
Dim Lotaria(3) As Integer
Lotaria(1)=int(10000*Rnd())
Lotaria(2)=int(10000*Rnd())
Lotaria(3)=int(10000*Rnd())
MsgBox Nmeros da lotaria: & Lotaria(1) & , & Lotaria(2) & , &_
Lotaria(3)
End Sub

Option Base e Array Bounds


A indexao de um array por defeito tem inicio em 0, sendo que os respectivos ndices vo
de 0 a dimenso-1. Para alterar a base de indexao por forma a ter inicio em 1 basta
colocar no inicio do mdulo Option Base 1
Contudo se pretender que um array comece noutro nmero que no seja 0 ou 1,
necessrio especificar os limites inferior e superior do ndice aquando da declarao do
array.

Exemplo:
Sub Utilizacao_Array()
Dim Lotaria(4 To 5) As Integer
Lotaria(4)=int(10000*Rnd())
Lotaria(5)=int(10000*Rnd())
MsgBox Nmeros da lotaria: & Lotaria(4) & , & Lotaria(5)
End Sub

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
59 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Constantes

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
60 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

O QUE SO CONSTANTES ?
Constantes so valores que no alteram durante a execuo de uma rotina. So declaradas
da mesma forma que as variveis, a nica diferena reside no facto da atribuio ser feita
na mesma instruo da declarao, e s poder ser feita uma nica vez.
Const <Nome_Constante> As <Tipo> = <Valor>
Const <Nome_Constante> As <Tipo> = <Expresso de clculo>

Figura 23 Manuseamento de Constantes

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
61 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

InputBox e
MsgBox

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
62 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

O QUE SO ?
Para haver interaco entre o utilizador e uma macro ou programa necessrio que exista
um interface de comunicao. Este poder ser mais ou menos complexo e completo,
contudo existem dois elementos bsicos para estabelecer esta ligao: InputBox e MsgBox.
Neste contexto a InputBox uma funo que permite ao utilizador introduzir dados no
programa portanto um mecanismo de input. O MsgBox um mecanismo de Output e
permite ao utilizador visualizar os dados produzidos pelo programa.

INPUTBOX
O que faz
1. Exibe no cran uma janela com uma caixa text box para a insero de dados.
2. Espera que o utilizador introduza os dados e/ou accione um dos botes.
3. Como uma funo produz um valor final. Este consiste nos dados inseridos pelo
utilizador na forma textual - String.

Sintaxe
InputBox(prompt[, title] [, default] [, xpos] [, ypos] [, helpfile, context])
Numa primeira avaliao da funo, pode-se dizer que a mesma possui diversos
parmetros, mas somente o primeiro obrigatrio, sendo que todos os outros quando
ignorados assumem valores atribudos por defeito.

Parmetros
Parmetro

Comentrio

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
63 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Prompt
(Obrigatrio )

Expresso textual exibida como mensagem na janela de input.


A dimenso mxima de 1024 caracteres.
Se se pretender construir uma mensagem com mais do que uma
linha poder utilizar o caractere Enter - Chr(13). A juno dos
elementos que constituem a mensagem realizada atravs do
operador &.
Exemplo:
"A Soma de 3 com 5 :" & Chr(13) & " 8 "

Title
(Facultativo)

Titulo da janela de input. Se este for omitido, aparecer por


defeito o nome da aplicao.

Default
(Facultativo)

Expresso inserida por defeito na caixa de insero de dados e


constituir a resposta por defeito se o utilizador no introduzir
outra.
Se este parmetro for omitido aparecer uma text box vazia.

Xpos
(Facultativo)

Nmero que identifica a distncia horizontal entre o lado


esquerdo do cran e a janela de input. Se este valor for omitido a
janela aparecer centrada horizontalmente.

Ypos
(Facultativo)

Nmero que identifica a distncia vertical entre o lado superior


do cran e a janela de input. Se este valor for omitido a janela
ficar posicionada a 1/3 da parte inferior do cran

HelpFile
(Facultativo)

Nome do ficheiro de Help que ser utilizado para dar apoio ao


preenchimento desta janela. Se for indicado este parmetro o
seguinte obrigatrio.

Context
(Facultativo)

Nmero do ndice do tpico de Help constante no ficheiro


HelpFile, e que corresponde janela em questo.

Ateno: Se pretender enviar mais que um parmetro optativo respeite a ordem


atravs de , (virgulas)
Exemplo:

InputBox(Introduza o Nome da Aplicao:, , Excel)


Na janela de input ser exibida a mensagem Introduza o Nome da Aplicao:, o ttulo da
caixa ser o definido por defeito e o valor na caixa de insero ser Excel.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
64 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

MSGBOX
O que faz
1. Exibe no cran uma janela com uma mensagem.
2. Espera que o utilizador accione um dos botes.
3. Como uma funo produz um valor final. Devolve um nmero inteiro indicando o
boto que foi clicado.

Sintaxe
MsgBox(prompt[, buttons] [, title] [, helpfile, context])
semelhana da InputBox , pode-se dizer que a mesma possui diversos parmetros, mas
somente o primeiro obrigatrio, sendo que todos os outros quando ignorados assumem
valores atribudos por defeito.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
65 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Parmetros
Parmetro
Prompt
(Obrigatrio )

Comentrio
Expresso textual exibida como mensagem na janela de input.
A dimenso mxima de 1024 caracteres.
Se se pretender construir uma mensagem com mais do que uma
linha poder utilizar o caractere Enter Chr(13)
Exemplo:
"A Soma de 3 com 5 :" & Chr(13) & " 8 "

Buttons
(Facultativo)

Nmero que identifica o tipo de botes que se pretende


visualizar na janela de output. Ver tabela seguinte.
Se for omitido assumir o valor 0 por defeito.

Title
(Facultativo)

Titulo da janela de input. Se este for omitido, aparecer por


defeito o nome da aplicao.

HelpFile
(Facultativo)

Nome do ficheiro de Help que ser utilizado para dar apoio ao


preenchimento desta janela. Se for indicado este parmetro o
seguinte obrigatrio.

Context
(Facultativo)

Nmero do ndice do tpico de Help constante no ficheiro


HelpFile, e que corresponde janela em questo.

Ateno: Se pretender enviar mais que um parmetro optativo respeite a ordem


atravs de , (virgulas)

Exemplo:

MsgBox(Erro de Sintaxe !!!, , Mensagem de Erro)


Na janela de output ser exibida a mensagem Erro de Sintaxe, o boto exibido ser o de
OK (por defeito) e o titulo da janela ser Mensagem de Erro.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
66 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Constante de VBA

Valor

VbOKOnly
VbOKCancel
VbAbortRetryIgnore
VbYesNoCancel
VbYesNo
VbRetryCancel
VbCritical
VbQuestion
VbExclamation
VbInformation
VbDefaultButton1
VbDefaultButton2
VbDefaultButton3
VbDefaultButton4
VbApplicationModal

0
1
2
3
4
5
16
32
48
64
0
256
512
768
0

VbSystemModal

4096

Descrio
Exibe somente o boto de OK.
Exibe os botes OK e Cancel.
Exibe os botes Abort, Retry, e Ignore.
Exibe os botes Yes, No, e Cancel .
Exibe os botes Yes e No.
Exibe os botes Retry e Cancel.
Exibe o cone de Critical Message.
Exibe o cone de Warning Query.
Exibe o cone de Warning Message.
Exibe o cone de Information Message.
O primeiro boto o seleccionado por defeito.
O segundo boto o seleccionado por defeito.
O terceiro boto o seleccionado por defeito.
O quarto boto o seleccionado por defeito.
Application modal o utilizador s depois de responder
MsgBox que poder dar continuidade ao trabalho na
aplicao corrente.
System modal - o utilizador s depois de responder
MsgBox que poder dar continuidade ao trabalho em
qualquer aplicao em curso no sistema.

Pela anlise desta tabela poder constatar que existem diferentes agrupamentos de cdigos:
para definir o tipo de botes (0-5), para definir o tipo de cones (16,32,48,64), para definir o
boto seleccionado por defeito (0,256,512,768) e para indicar o modo de execuo (0 e
4096). Poder adicionar os cdigos e assim fazer combinaes entre diversas opes destes
4 grupos, contudo nunca dever adicionar mais do que um cdigo por agrupamento.

Exemplos:
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
67 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Para a instruo:
MsgBox "Erro de Sintaxe!!!", 2 + 48 + 512 + 4096, "Mensagem de Erro"

exibida a seguinte janela:

Figura 24 MsgBox

Para a instruo:
MsgBox "Erro de Sintaxe!!!", 5 + 64 + 256 + 4096, "Mensagem de Erro"
exibida a seguinte janela:

Figura 25 MsgBox

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
68 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Valores Produzidos
Como j foi referido, a funo MsgBox produz um valor em funo do boto accionado,
assim produzir como output um dos valores constantes da tabela seguinte:

Constante de VBA
vbOK
vbCancel
vbAbort
vbRetry
vbIgnore
vbYes
vbNo

Valor

Boto Accionado

1
2
3
4
5
6
7

OK
Cancel
Abort
Retry
Ignore
Yes
No

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
69 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Domnio das
variveis,
constantes e
rotinas

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
70 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

O QUE O DOMINIO?
Scope ou domnio de um elemento refere-se rea na aplicao na qual esse mesmo
elemento pode ser acedvel e utilizado, ou seja onde que o elemento reconhecido.

DOMNIO DAS VARIVEIS


Refere-se rea onde a varivel permanece activa, mantendo o valor que lhe vai sendo
atribudo.
Existem 3 nveis de domnio para as variveis:

mbito do Procedimento ou Procedimental


mbito do Modulo ou Modular
mbito do Projecto

As declaraes de tipos User Defined que so escritas no Declarations do mdulo tm


domnio de Projecto.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
71 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

mbito do Procedimento
Estas variveis so declaradas no corpo do procedimento com recurso palavra chave Dim.
So variveis criadas aquando da execuo do procedimento e automaticamente destrudas
quando o procedimento termina, sendo que s so reconhecidas no seio do procedimento
que as declarou. Assim sendo, qualquer tentativa realizada por um procedimento no
sentido de trabalhar com variveis definidas no corpo de um outro procedimento no ter
xito.

Exemplo
Sub Ambito_Procedimento()
Dim Var_1 As Integer
Var_1 = InputBox (Introduza um nmero Inteiro)
MsgBox Foi este o nmero que introduziu: & Var_1
Ambito_Procedimento_2
End Sub
Sub Ambito_Procedimento_2()
MsgBox Foi este o nmero que introduziu: & Var_1
End Sub

A execuo destas rotinas resultar no seguinte:


A primeira mensagem (MsgBox no Procedimento Ambito_Procedimento)exibir o
nmero introduzido pelo utilizador que fora armazenado na varivel Var_1.
A segunda mensagem, oriunda da instruo MsgBox do Procedimento
Ambito_Procedimento_2 no exibir o valor introduzido, porque a varivel Var_1 nele
referida considerada como uma varivel interna do processo, e portanto criada dentro do
procedimento Ambito_Procedimento_2. Como tal, embora possua o mesmo nome que a
varivel da rotina Ambito_Procedimento_1 no existe qualquer ligao entre elas, so duas
variveis distintas.
Neste caso se se pretendesse que o valor da primeira varivel fosse reconhecido no
procedimento chamado, ter-se-ia de o passar por parmetro.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
72 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

mbito do Mdulo
Uma varivel como mbito do Mdulo pode ser acedida por todas as rotinas existentes
no mdulo onde a varivel declarada.
Para declarar uma varivel do nvel modular, dever declar-la com a palavra chave Dim
na seco Declarations do respectivo mdulo VBA. Neste caso qualquer varivel a
declarada ser considerada de nvel modular por defeito, para tornar esse facto mais
explicito poder-se- utilizar a palavra chave Private na declarao:
Ex:
Private Var_2 As String

Exemplo:
Dim Var_1 As Integer ou Private Var_1 As Integer
Sub Ambito_Modulo()
Var_1 = InputBox (Introduza um nmero Inteiro)
Ambito_Modulo_2
End Sub
Sub Ambito_Modulo_2()
MsgBox Foi este o nmero que introduziu: & Var_1
End Sub

Neste caso como a varivel reconhecida no mdulo por qualquer rotina nele existente,
desde que seja referida sempre pelo mesmo nome, o procedimento Ambito_Modulo_2 ir
exibir o valor introduzido pelo utilizador no procedimento Ambito_Modulo.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
73 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

mbito do Projecto
As variveis assim definidas tm o mbito correspondente a todo o projecto, isto podem
ser acedidas e alteradas em todos e quaisquer mdulos. Para declarar variveis deste
tipo dever faz-lo na seco Declarations de qualquer mdulo, para tal dever utilizar a
palavra chave Public.

Exemplo:
No Module_1 tem-se:
Public Var_1 As Integer
Sub Ambito_Projecto()
Var_1 = InputBox (Introduza um nmero Inteiro)
Ambito_Projecto _2
End Sub

No Module_2 tem-se:
Sub Ambito_Projecto _2()
MsgBox Foi este o nmero que introduziu: & Var_1
End Sub

A execuo do procedimento Ambito_Projecto no Module_1 mandou executar o


procedimento Ambito_Projecto do Module_2, e o valor atribudo varivel Var_1 foi
acedido posteriormente noutro procedimento de outro mdulo, dado tratar-se de uma
varivel global.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
74 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

DOMNIO DAS CONSTANTES


semelhana das variveis tambm as constantes tm 3 nveis de domnio:

mbito do Procedimento ou Procedimental


mbito do Modulo ou Modular
mbito do Projecto

mbito do Procedimento
Estas constantes so declaradas no corpo do procedimento com recurso palavra chave
Const. S tm existncia dentro do procedimento onde so declaradas.

Exemplo:
Sub Ambito_Procedimento()
Const Taxa_Desc As Single = 0.05
Dim Desconto As Double
Desconto = InputBox (Introduza o montante das Compras) * Taxa_Desc
MsgBox O desconto de : & Desconto
End Sub

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
75 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

mbito do Mdulo
Uma constante com mbito do Mdulo pode ser utilizada por todas as rotinas existentes
no mdulo onde definida.
Para declarar uma constante a nvel modular, dever declar-la com a palavra chave Const
na seco Declarations do respectivo mdulo VBA. Neste caso qualquer constante a
declarada ser considerada de nvel modular por defeito, para tornar esse facto mais
explicito poder-se- utilizar a palavra chave Private na declarao:
Ex:
Private Const Const_1 As String

mbito do Projecto
As constantes assim definidas tm o mbito correspondente a todo o projecto, isto
podem ser utilizadas em todos e qualquer mdulo. Para definir constantes deste tipo dever
faz-lo na seco Declarations de qualquer mdulo, para tal dever utilizar a palavra
chave Public.
Ex:
Public Const Const_1 As String

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
76 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

DOMNIO DE SUBROTINAS E FUNES


Estas s tm dois nveis de Scope: o nvel do projecto e o nvel do mdulo.
Por defeito as rotinas so de mbito do projecto sem qualquer indicao adicional. Contudo
poder tornar este facto mais explicito pela introduo da Palavra-Chave Public, que em
termos operacionais no adicionar qualquer funcionalidade, mas em termos de leitura dar
uma maior percepo.

Exemplo:
Public Sub Ambito_Procedimento()
Const Taxa_Desc As Single = 0.05
Dim Desconto As Double
Desconto = InputBox (Introduza o montante das Compras) * Taxa_Desc
MsgBox O desconto de : & Desconto
End Sub

Para que uma rotina tenha o mbito do mdulo onde est definida, dever ser antecedida
pela palavra chave Private.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
77 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Estruturas de
Controlo

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
78 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

O QUE SO ESTRUTURAS DE CONTROLO?


O VBA disponibiliza algumas estruturas que pode utilizar para controlar o decurso da
execuo da rotina. Estas estruturas do ao programador um poder enorme para construir
rotinas bastante complexas e flexveis.

QUAIS AS ESTRUTURAS
VBA Control
If -Then - Else

Testa uma condio e executa um determinado conjunto de


instrues consoante o resultado dessa avaliao

For Next

Executa uma determinada tarefa um determinado nmero de


vezes.

While-Wend

Executa uma determinada tarefa enquanto que uma


determinada condio permanea verdadeira, i.e., com o
valor True.

Do Loop

Executa uma determinada tarefa enquanto que a avaliao de


uma condio permanea True ou ento at que seja True.

Select - Case

Selecciona um dos segmentos de cdigo a processar


mediante a avaliao consecutiva de condies.

For Each Next

Realiza uma determinada tarefa repetitiva em cada objecto


de uma coleco ou em cada item de um array.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
79 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

IF-THEN-ELSE
Funo IF do Excel
Recorrendo funo IF do Excel, recorde:
=IF( <condio>, <se condio verdadeira>, <se condio falsa> )
A funo IF tinha o seguinte comportamento:
1. Avalia a condio, que dever ser uma expresso booleana colocada como primeiro
parmetro;
2. Se a condio for verdadeira, ento (then) realiza as operaes colocadas no segundo
parmetro;
3. Caso contrrio (else), realiza as operaes que formam o terceiro parmetro
A estrutura IF do VBA tem o mesmo tipo de funcionamento, o que difere a sintaxe.

Sintaxe da Estrutura If-Then-Else


If <Condio> Then
<se condio verdadeira>
[ Else
<se condio falsa> ]
End If
A palavra Else opcional num If-Then-Else Statement, sendo que no caso de ser omitida, a
avaliao negativa da condio implica uma sada automtica da Instruo If.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
80 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Aplicao Prtica

Figura 26 Aplicao Prtica com um IF

A rotina Aposta recebe uma aposta do utilizador e mediante o Sorteio a realizar pela
respectiva funo, verifica se o jogador ganhou ou no a aposta, comunicando-lhe esse
facto.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
81 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Para uma maior clarificao do funcionamento do IF, atenda ao quadro seguinte:

If

Palavra chave que indica o inicio de uma instruo If-Then-Else

Nsorteio = NAposta

A condio a testar. Serve para determinar a sequncia a dar execuo


da rotina. Da avaliao desta condio pode-se obter um de dois valores
True ou False, sendo que depende deste resultado o caminho a prosseguir.
Se for True executar as instrues que seguirem a palavra-chave Then
at encontrar a palavra chave Else, no executando mais nada dentro do
IF, caso contrrio executar o cdigo que se seguir palavra chave Else
at ao End If.

Then

Palavra chave que determina o fim da condio teste. Todas as instrues


que tm inicio nesta palavra-chave at palavra-chave Else sero
executadas se a condio for verdadeira.

Instrues a executar se a condio for verdadeira.


MsgBox Parabns!!
Acertou em cheio! O
nmero sorteado foi o
&NSorteio
Else

Palavra-chave que determina o terminus de execuo das instrues


quando o resultado da avaliao for True, e que determina o inicio das
instrues a executar se o resultado da condio for False.

MsgBox Continue a Instrues a executar se a condio for falsa.


Tentar!! O nmero
sorteado foi o
&NSorteio
End If

Palavra-chave que indica o fim do controlo de If-Then-Else e como tal


onde se deve retomar as instrues para prosseguir a execuo do
procedimento.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
82 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

A instruo adicional ElseIf


Esta instruo prope uma condio alternativa se o teste da condio anterior tiver tido um
resultado negativo.

APLICAO PRTICA
Pretende-se criar uma macro que classifique etariamente um indivduo em funo da sua
idade. A classificao pretendida a seguinte:

Idade
Menos de 3 anos
Dos 3 aos 12
Dos 13 aos 17
Dos 18 aos 25
Dos 26 aos 65
Mais de 65

Classe Etria
Beb
Criana
Adolescente
Jovem
Adulto
Idoso

Figura 27 Aplicao Prtica com ElseIf

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
83 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

FOR NEXT
Permite a execuo de uma tarefa durante um determinado nmero de vezes.

Sintaxe
For <Inicializao do Contador> To <Valor > [ Step <Valor a Incrementar>]
<Instrues a realizar em cada iterao>
Next

Aplicao Prtica
Pretende-se criar uma rotina que recebendo a base e a potncia calcule o valor respectivo.

Figura 28 Procedimento que calcula a potncia de um nmero

A instruo For-Next tem como funo calcular a potncia. O mesmo efeito poderia ser
obtido recorrendo expresso Resultado = Base ^ Potncia, contudo para fins de
demonstrao de funcionamento este exemplo bastante simples.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
84 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

A FUNO DAS VARIVEIS:


Varivel
Base
Potncia
Contador

Resultado

Funo
Elemento a elevar.
Nmero de vezes a multiplicar a base.
Conta o nmero de vezes que a base j foi multiplicada, uma
varivel que ser automaticamente incrementada em cada looping do
ciclo.
Varivel que armazena o resultado sucessivo por cada vez que se
multiplica.

CONSTRUO DO CICLO:
For

Palavra-chave que indica o inicio do ciclo For-Next

Contador = 1 To Potncia Expresso que contm a inicializao do contador, indicando


o valor de inicio e de fim. Assim, o nmero de vezes que o
ciclo executado ser: Valor_Fim Valor_Inicio +1.
A palavra To utilizada para separar o valor do contador no
momento inicial do valor no momento final. (Traduo: O
contador iniciar-se- a um e atingir o valor mximo
traduzido pela varivel Potncia)
Step 1

Palavra chave utilizada para especificar o valor a incrementar


ou decrementar ao contador do ciclo por cada vez que o loop
concretizado. Normalmente o valor a incrementar um,
contudo qualquer outro valor pode ser utilizado, desde
nmeros decimais, a nmeros negativos (Provocando assim a
decrementao). A palavra-chave Step opcional, sempre
que for omitida assumido 1 como o valor a incrementar por
defeito.

Resultado = Resultado * Instruo a realizar de cada vez que o ciclo for executado.
Neste caso a instruo nica, contudo poder-se-o adicionar
Base
outras instrues.
Next

Palavra Chave que indica o fim de um ciclo For-Next .


Sempre que a execuo do ciclo chega instruo Next
incrementa a varivel contador e volta ao inicio do ciclo.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
85 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

TRADUO INTEGRAL
For Contador = 1 To Potncia Step 1
Resultado = Resultado * Base
Next
Para o nmero de vezes, a iniciar em 1 at que atinja, o valor Potncia, pela incrementao
de 1 na execuo de cada ciclo, dever multiplicar sucessivamente o resultado acumulado,
pela base.

Funcionamento do Ciclo:
A primeira execuo do ciclo distingue-se das restantes por a ela estar associada a
inicializao do contador, sendo o restante procedimento semelhante a qualquer outra
execuo.
No inicio de cada execuo do ciclo, a varivel contador comparada com o valor final de
execuo. Se o Step for um valor positivo (incrementar) e o valor do contador for superior
ao valor final significa que o ciclo j foi realizado o nmero de vezes pretendido, e ento o
cdigo acabar a execuo da instruo For-Next e seguir na linha de cdigo que esteja
situada imediatamente a seguir, caso contrrio executa uma vez mais o ciclo e incrementa a
varivel contador. Por outro lado, se o Step contiver valor negativo (decrementar) e o
valor do contador for inferior ao valor final significa que o ciclo j foi realizado o nmero
de vezes pretendido, e ento o cdigo acabar a execuo da instruo For-Next e seguir
na linha de cdigo que esteja situada imediatamente a seguir, caso contrrio executa uma
vez mais o ciclo e decrementa a varivel contador.

Perigos associados utilizao do ciclo For-Next:

No definir o limite de execuo (no atribuir valor varivel que o define)


Definir erroneamente o Step, por forma a que nunca seja obtido o valor que determina o
fim da execuo
estas condies implicaro que o ciclo no tenha fim Ciclos Infinitos

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
86 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Outra Aplicao
Pretende-se criar uma rotina para calcular um factorial.

Figura 29 Procedimento que calcula o factorial

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
87 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

WHILE-WEND
A estrutura While-Wend tem um funcionamento similar ao For-Next. Realiza um looping
um determinado nmero de vezes, at que uma determinada condio seja verdadeira.

Sintaxe
While <Condio>
<Instrues a realizar em cada iterao>
Wend

Aplicao Prtica

Figura 30 Procedimento Lotaria Viciada

A instruo While-Wend tem como funo gerar nmeros aleatrios entre 1 e 10 por forma
a encontrar o nmero da aposta, e saber qual o nmero de lanamentos necessrios para que
aquele valor fosse obtido.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
88 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

A FUNO DAS VARIVEIS:


Varivel

Funo

Num_Lotaria

Nmero sorteado. Este ser inicializado a 0 por forma a que no


corresponda a nenhum valor introduzido pelo utilizador e assim possa
realizar o primeiro sorteio.

Aposta

Nmero em que o utilizador pretende apostar.

Num_Lanc

Nmero de lanamentos realizados at obter o resultado da aposta.


Este valor tem de ser incrementado cada vez que realizado um
sorteio.

CONSTRUO DO CICLO:
While

Palavra-chave que indica o inicio do ciclo WhileWend

Num_Lotaria <> Aposta

Condio teste utilizada para determinar o


terminus da realizao do ciclo. Se esta condio
for Verdadeira executa as instrues que esto
dentro do While-Wend, se for Falsa a execuo
do ciclo terminada tendo o programa sequncia
nas instrues que seguem a palavra chave Wend.

Num_Lotaria = Int ( 9 * Rnd() + 1 )

Instruo a realizar de cada vez que o ciclo


executado. Tem como funo gerar nmeros
aleatrios entre 1 e 10.

Num_Lanc = Num_Lanc +1

Instruo a realizar de cada vez que o ciclo


executado. Tem como funo fazer a contagem
de quantos lanamentos foram realizados at se
obter o valor da aposta.

Beep

Instruo a realizar de cada vez que o ciclo


executado. Tem como funo apitar em cada
sorteio.

Wend

Palavra Chave que indica o fim de um ciclo


While-Wend.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
89 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

TRADUO INTEGRAL
While Num_Lotaria <> Aposta
Num_Lotaria = Int ( 9 * Rnd() + 1 )
Num_Lanc = Num_Lanc +1
Beep
Wend
Enquanto o nmero sorteado no for igual ao valor da aposta, o sorteio continua, o que
implica sortear um nmero contabilizar o nmero de sorteios realizados e apitar para que o
utilizador tenha a percepo do que est a ser realizado.

Funcionamento do Ciclo
Existe uma fase de inicializao das variveis envolvidas na condio Teste para garantir
o correcto funcionamento do ciclo.
Avalia a condio teste e se for verdadeira executa todas as instrues at palavra-chave
Wend voltando de novo avaliao da condio, se for falsa prossegue a execuo da
rotina nas instrues que se localizam depois da palavra-chave Wend.

Perigos associados utilizao do ciclo While-Wend

M ou inexistncia de inicializao das variveis envolvidas na condio-teste.


Garantir que as variveis envolvidas na condio teste podero ter valores diferentes
por cada vez que o ciclo seja executado.
Garantir que em algum momento a condio teste falsa e o ciclo termina a sua
execuo.

A no verificao destas condies implicar que o ciclo no tenha fim Ciclos


Infinitos

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
90 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Outra Aplicao
Pretende-se realizar um jogo de geografia. Tente compreender o seu funcionamento.

Figura 31 Corpo do jogo

Figura 32 Funo Auxiliar

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
91 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

DO LOOP
Esta estrutura similar estrutura do While-Wend. Contudo fornece duas possibilidades
que esto limitadas quela estrutura:

Do Loop permite posicionar a condio teste no inicio ou fim do loop, a condio no


fim do Loop evita uma inicializao prvia do valor das variveis envolvidas na
condio teste, dado que essa inicializao pode ser feita no decurso do ciclo com
valores reais.

Do Loop permite ainda especificar se o loop se vai realizar enquanto (while) uma
expresso for verdadeira ou at que (until) a condio seja verdadeira (facilidade
conseguida atravs do operador Not)

Sintaxe
Poder ser:
Do [{While | Until} <condio>]
<Instrues a realizar em cada iterao>
Loop

Ou ento:
Do
<Instrues a realizar em cada iterao>
Loop[{While | Until} <condio>]

Aplicaes Prticas
Utilizando a condio teste no inicio do Loop e com a palavra While
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
92 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Figura 33 Condio teste no inicio com While

Utilizando a condio teste no inicio do Loop e com a palavra Until

Figura 34 Condio teste no inicio com Until

Utilizando a condio teste no fim do Loop e com a palavra Until

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
93 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Figura 35 Condio teste no fim com Until

Utilizando a condio teste no fim do Loop e com a palavra While

Figura 36 Condio teste no fim com While

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
94 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

SELECT CASE
Permite a escolha de um percurso mediante a avaliao de n condies. de extrema
utilidade para evitar os Ifs encadeados, dando um maior grau de legibilidade e
simplicidade ao cdigo construdo.

Sintaxe
Select Case <Expresso a ser avaliada>
[Case <Valor da Expresso> [Instrues a realizar]]
...[Case Else [Instrues a realizar na situao residual]]
End Select

Aplicao Prtica
Recordem o processo resolvido com recurso a If Then Else ElseIf (figura 23)
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
95 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


Mais facilmente seria resolvido com recurso estrutura Select Case

Figura 37 Aplicao da estrutura Select Case rotina Classe_Etaria

CONSTRUO DA ESTRUTURA
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
96 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


Select Case

Palavras-Chave que indicam o inicio de um controlo


Select Case

Idade

Expresso sujeita a teste, i.e., varivel cujo contedo


est a ser avaliado. Esta varivel vai ser comparada
sucessivamente
pelos
valores
alternativos
apresentados nas instrues Case <Valor>, se
encontrar o valor nalguma dessas opes Case
executar as linhas de cdigo que a tero inicio at
opo de Case seguinte. Caso o valor da varivel a
ser comparada no corresponda a nenhum valor
apresentado nas opes Case, existe uma opo Case
especial - Case Select - para os restantes valores,
neste caso sero executadas todas as instrues que
se localizem entre o Case Else e o Case Select.

Case Is<3 ou
Case Is<=12 ou
Case Is<=17 ou
Case Is<=25 ou
Case Is<=65 ou

Expresses Case. Se o valor da varivel for igual a


qualquer um dos valores apresentados em cada uma
destas expresses, o fluxo de execuo ter
continuidade na linha abaixo da expresso case que
faz o matching, at que uma nova expresso case
seja encontrada. Sendo que nessa altura termina o
controlo Select Case dando continuidade ao
programa nas instrues que se seguirem ao End
Select.

Case Else

Ser a instruo Case residual, seleccionada somente


se nenhuma das outras o tiver sido. Neste caso sero
realizadas todas as instrues de cdigo que se lhe
seguirem at expresso End Select. Findo o qual
seguir todas as instrues aps o controlo Select
case.

End Select

Palavra-Chave que indica o fim do controlo Select


Case.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
97 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

FOR EACH NEXT


A estrutura For-each-next de longe a mais potente do VBA. De facto permite executar
uma determinada instruo em todos os elementos de uma coleco de objectos, ou em
todos os elementos de um array.
Esta estrutura quando aplicada em arrays no funciona para a actualizao dos valores do
array, mas somente para a extraco do seu contedo. Contudo quando aplicada a coleces
de objectos pode s-lo para alterao das suas propriedades ou extraco de valores.

Sintaxe
For Each <Varivel do tipo dos elementos do grupo> In <Grupo>
<Instrues a realizar para cada elemento do grupo>
Next

Aplicaes Prticas

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
98 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

UTILIZANDO ARRAYS
Pretende-se inicializar um array com um conjunto de 5 pases e posteriormente visualizar
os elementos introduzidos.

Figura 38 Exemplo no-funcional

Repare que o exemplo, poder estar conceptualmente correcto, mas no funciona devido
restrio do For-Each-Next para a alterao de valores de arrays tarefa impossvel de
realizar. A alternativa poderia ser, a exibida na figura 39:

Figura 39 Alterao da sub-rotina Inicializa_Array

Construo do Ciclo
______________________________________________________________________________________L
EANDRO ALVES FERREIRA
99 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

For Each

Palavras-Chave que indicam o inicio de um controlo


For-Each

Pais

Varivel qual vo ser atribudos sucessivamente


todos os elementos do grupo de objectos. Este grupo
pode ser constitudo por uma array ou uma coleco
de objectos. Sendo que se se tratar de um array
esta varivel dever ser do tipo Variant. Se se tratar
de uma coleco, esta varivel poder assumir o tipo
Variant, o tipo Object genrico ou o tipo Object
especifico que corresponde ao tipo de objectos a que
a coleco remete.

In

Palavra-chave que separa a varivel do grupo.

Array_Pais

Grupo de elementos a tratar. Poder ser um array ou


uma coleco de objectos. O ciclo ser executado
tantas vezes quantos os elementos constantes do
grupo. Na primeira iterao, a varivel assume o
valor do primeiro item do grupo, como tal em cada
loop este valor ser actualizado pelo item seguinte.

MsgBox Pais

Instruo a realizar em cada volta do ciclo. Sendo


que em cada volta a varivel Pais ter um elemento
diferente.

Next

Palavra-chave que indica o fim do loop. Neste


momento o programa ter continuao na instruo
For Each correspondente se a varivel no
corresponder ao ltimo item do grupo, caso contrrio
sair da instruo For Each-Next prosseguindo a
execuo da rotina na linha de cdigo abaixo do
Next.

UTILIZANDO COLECES DE OBJECTOS


______________________________________________________________________________________L
EANDRO ALVES FERREIRA
100 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Figura 40 Rotina para atribuir nomes s WorkSheets do Excel

Figura 41 Rotina para demonstrar o manuseamento de ranges

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
101 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Coleces de
Objectos e
Objectos

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
102 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

O QUE SO OBJECTOS ?
Objectos so elementos caracterizados por um conjunto de propriedades, e que tm
subjacente um determinado comportamento. Por exemplo, uma janela do windows um
objecto, caracterizada por um nome, um ttulo, uma dimenso, um posicionamento dentro
do cran,, e tem um comportamento inerente, pode ser aberta, fechada, minimizada,
maximizada, escondida, redimensionada,
Seguindo esta lgica podemos identificar alguns objectos do ambiente de trabalho
Windows: o boto, o grfico, o menu, o documento, a imagem, a textbox, a frmula, o
workbook, a worksheet, a clula, o conjunto de clulas de uma worksheet,

OBJECTOS: PROPRIEDADES, MTODOS E


EVENTOS
Propriedades
As propriedades dos objectos constituem o conjunto de caracteristicas que o definem. Por
exemplo: nome, cor, dimenso, designao, valor contido,

Mtodos
Os mtodos traduzem o comportamento de um objecto. Estes mtodos representam
procedimentos que executam uma determinada tarefa, que pode ser complementada atravs
da passagem de argumentos ou parmetros.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
103 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Eventos
Eventos ou acontecimentos, representam todas as actividades que envolvam o objecto e que
normalmente directa ou indirectamente so despoletadas pelo utilizador. Por exemplo: abrir
ou fechar um workbook, clicar sobre um boto ou worksheet, alterar o contedo de um
elemento,
Estes eventos servem para que possamos activar uma determinada tarefa aquando da sua
ocorrncia.

Exemplo:
Suponha que pretende executar uma macro quando abre o seu workbook.
1 Crie a macro que pretende executar.
2 No Editor de Visual Basic, na janela de Projecto Project Window seleccione o
objecto ThisWorkBook. Na janela de edio repare nas duas caixinhas que se encontram na
parte superior. A do lado esquerdo indica general clique nela e seleccione o elemento
workbook, na caixinha da direita seleccione o evento Open.
3 Automaticamente aparecer um procedimento na janela de edio cujo nome ser
Workbook_Open, tudo o que escrever no seu contedo ser executado quando o documento
for aberto, neste caso indique o nome da macro que criou anteriormente.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
104 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

OBJECTOS MAIS UTILIZADOS NO EXCEL


Os Objectos mais utilizados no Excel so: Application, WorkBook, WorkSheet e Range

Application
Application o objecto de topo hierrquico, representa o prprio Excel.

PROPRIEDADES
Propriedades
Caption

Meno exibida na barra de ttulos do Excel

DisplayAlerts

TRUE as mensagens de alerta so exibidas durante a


execuo da subrotina. False caso contrrio.

Path

Nome da directoria onde o Excel est instalado.

ScreenUpdating

True altera o cran consoante a subrotina que executa.


Caso contrrio, o cran no alterado durante a execuo da
subrotina.

WindoWorkSheetState

O estado da janela da aplicao:


XlNormal janela tamanho normal
XlMaximized janela tamanho maximizado
XlMinimized janela com tamanho minimizado

DisplayStatusBar

Mostra ou esconde a StatusBar.


True exibe

DisplayFormulaBar

Mostra ou esconde a Barra de Formulas


True exibe

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
105 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

MTODOS
Mtodos
Calculate

Implica o clculo de todas as frmulas de todas as WorkSheet e


WorkBookS abertos.
Argumentos : no tem

Help

Exibe um tpico do Help de um determinado ficheiro de Help.


Argumentos :
Helpfile: nome do ficheiro, incluindo a path se necessrio
Helpcontextid: nmero que faz referncia ao ndice de help

Quit

Fecha aplicao Excel. (se a propriedade Display alerts estiver com o


valor False, o Excel no propor a gravao de alteraes nos
ficheiros)
Argumentos : no tem

Run

Utilizado para correr uma subrotina de VB ou uma Macro do XL


Argumentos :
Macro: nome da macro ou subrotina a executar
Argumentos que a subrotina necessita para ser executada
arg1:=<valor 1>, arg2:=<valor>,

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
106 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

WorkBook
O Objecto WorkBook, na hierarquia de objectos segue de imediato o objecto application e
representa um ficheiro de Excel.

PROPRIEDADES
Propriedades
Name

Nome do ficheiro. No permite a alterao do nome, para isso


necessrio proceder ao Save/As

Path

Directoria onde o ficheiro se encontra

Saved

True se no houve nenhuma alterao no ficheiro desde a


ltima gravao
False caso contrrio
Exemplo:
If not(activeWorkbook.Saved) Then
ActiveWorkbook.Save
End If

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
107 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

MTODOS
Mtodos
Activate

Activa um documento aberto. Equivalente a ir ao Window e seleccionar


um documento aberto, trazendo-o para a janela principal do Excel.
Argumentos: no tem

Close

Fecha um documento.
Argumentos:
SaveChanges se True, o documento gravado antes de ser
fechado; False caso contrrio
FileName se o argumento SaveChanges estiver a TRUE, o
WorkBook gravado com o nome aqui indicado
RoutWorkBook se TRUE e o WorkBook tiver endereos
para envio atribudos, envia o ficheiro por e-mail antes de fechar,
caso contrrio no.

Protect

Protege um documento contra qualquer tipo de alterao


Argumentos:
Password: Password a utilizar na proteco
Structure: True protege tambm a estrutura
WindoWorkSheet: True a estrutura do WorkBook na janela
protegida

Save

Grava o WorkBook.
Argumentos: No Tem

SaveCopyAs

Cria uma cpia do documento em questo


Argumentos:
FileName: nome da cpia pretendida para o ficheiro

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
108 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

WorkSheet
Na hierarquia situa-se abaixo do objecto WorkBook, uma vez que um WorkBook
constitudo por um conjunto de WorkSheets.

PROPRIEDADES
Propriedades
Index

ndice de uma WorkSheet num WorkBook

Name

Nome da WorkSheet.

UsedRange

Traduz o range na WorkSheet que contm dados.

Visible

True est visvel


False est escondida, mas o utilizador pode vizualiz-la
recorrendo ao Menu Format
XlVeryHidden est escondida e ningum a pode visualizar, a
menos que volte a aplicar uma subrotina que a coloque visvel.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
109 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

MTODOS
Mtodos
Activate

Activa uma determinada WorkSheet. Equivalente a estarmos a


trabalhar num WorkBook e clicarmos nela para visualizarmos
o seu contedo.
Argumentos: No Tem

Calculate

Provoca o clculo de todas as frmulas constantes da


WorkSheet
Argumentos: No Tem

Delete

Apaga uma WorkSheet do WorkBook.


Argumentos: No Tem

Protect

Protege uma WorkSheet contra qualquer tipo de alterao


Argumentos:
Password: Password a utilizar na proteco
DrawingObjects: True- protege os objectos grficos
Contents True- protege as clulas e contedos
Scenarios True protege os cenrios afectos WorkSheet
UserInterfaceOnly True protege os interfaces contra
alteraes apesar de poder alterar as subrotinas

Cell

Referncia uma clula, atravs dos seus ndices numricos.


Argumentos:
Nmero da Linha
Nmero da Coluna
Ex: Clula C5 ser representado por Cells( 5, 3)

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
110 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Range
Objecto utilizado para representar uma ou mais clulas de uma WorkSheet.

PROPRIEDADES
Propriedades
Count
Dependents
Name
Value
Formula
Text

Nmero de Clulas num Range. Read-Only


Retorna um range, que contm todos os dependentes (valores
indexados pelas frmulas)do range em questo. Read-Only
Nome de um range. Read/Write
Valor constante de um range (clula ou conjunto de clulas).
Read/Write
Traduz a frmula contida num range como uma string.
Read/Write
Busca o contedo de uma clula mas em formato de texto.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
111 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

MTODOS
Mtodos
Calculate
ClearContents

Copy

OffSet

EntireRow

Select

Cell

Provoca o clculo da frmula constantes do range


Argumentos: No Tem
Apaga o contedo (frmulas e valores) de uma clula,
deixando os formatos.
Argumentos: No Tem
Copia o contedo de um range para um outro de igual
dimenso ou ento para o clipboard.
Argumentos:
Destination range para o qual os valores vo ser copiados (na
ausncia deste parmetro a cpia feita para o clipboard)
Provoca um deslocamento de um determinado nmero de
linhas e de colunas, tendo como base o range ao qual este
mtodo est a ser aplicado.
Argumentos:
RowOffset nmero de linhas que se desloca
ColumnOffset nmero de colunas que se desloca
Faz referncia (s) linha(s) indicadas por um determinado
range.
Argumentos: No Tem
Selecciona o range em questo.
Argumentos:
Replace- (Opcional)
Referncia uma clula, atravs dos seus ndices numricos.
Argumentos:
Nmero da Linha
Nmero da Coluna
Ex: Clula C5 ser representado por Cells( 5, 3)

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
112 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

OBJECTOS SINGULARES VS
COLECES DE OBJECTOS
Objecto Singular refere um nico objecto que pode ser referenciado pelo nome.
Coleces de Objectos constituem conjuntos de objectos singulares que so
referenciados pelo ndice que os identifica na coleco.

As coleces de objectos tambm podem ser considerados como objectos.


Exemplo:
WorkBooks(Book1.XLS) um conjunto de objectos do tipo WorkSheet, mas tambm
um objecto do tipo WorkBook.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
113 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

INDEXAO DE COLECES POR NMERO


OU NOME

Perante uma coleco de objectos necessrio identificar cada um dos diferentes itens que
a compem para que a eles seja possvel aceder.
Por analogia poder-se- mencionar o exemplo do array, este uma varivel plural, dado
que composto por um conjunto de variveis. Quando se pretende aceder a uma posio do
array utiliza-se o nome do array e o ndice da posio requerida.
Assim, a indexao de coleces pode ser realizada com base:
em nmeros ou
em nomes.

Indexao com Base em Nmeros


Os nmeros prendem-se com a ordem pela qual o objecto est inserido na coleco
(comea em 1).

Exemplo:
WorkSheets(3).Name=Terceiro

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
114 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Indexao com Base no Nome


Selecciona-se um objecto numa coleco pelo nome que est associado ao objecto.

Exemplo:
WorkSheets(Sheet3).Name=Terceiro

VANTAGEM
No necessrio saber a ordem pela qual foi inserido na coleco

DESVANTAGEM
Alterao do nome da sheet provoca erros

Exemplo:
WorkSheets(Sheet3).Name=Terceiro
WorkSheets(Sheet3).Visible=False o objecto no reconhecido

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
115 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

O Objecto Range uma excepo


O objecto range referido da mesma forma para ser utilizado como um objecto singular ou
coleco de objectos.

TRATAMENTO COMO OBJECTO:


Range(A1).Value=1
Equivalente a colocar na primeira clula da Sheet o valor 1.

TRATAMENTO COMO COLECO DE OBJECTOS:


Range (A1:F20).Value= 1
Equivalente a colocar em todas as clulas do range A1 a F20 o valor 1.

Ou ento:
Range (A1:F20).Name= Conjunto
Range (Conjunto).Value= 1
Onde, na primeira instruo se atribui ao range A1:F20 o nome Conjunto, e na ltima
instruo se utiliza essa designao para referenciar o respectivo conjunto de clulas e
atribuir-lhe o valor 1.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
116 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

REFERNCIA IMPLCITA
Quando se faz referncia a uma clula da worksheet, pode-se faz-lo de diversas formas
equivalentes. No quadro seguinte exibida a equivalncia entre a expresso mais completa
e a mais reduzida, sendo que ambas tm a mesma funo (colocar na clula A1 o valor 1):

Aplication.Workbooks(1).Worksheets(1).Range(A1).Value=1
Range(A1).Value=1
A diferena entre ambas as formas de acesso est no facto da segunda forma
(Range(A1).Value = 1) admitir que se est a trabalhar no workbook e na worksheet que
nesse momento esto activas no Excel, enquanto que na primeira forma so indicadas as
referncias identificadoras do workbook e da worksheet onde se pretende trabalhar.
Assim, pode-se afirmar que a segunda forma faz uma aluso implcita aplicao, ao
workbook e worksheet onde se trabalha.

Declarao implcita da aplicao:


Para fazer a aluso implicita da aplicao, basta no a indicar, e por defeito o Excel assume
que se est a trabalhar no seu contexto:

Workbooks(1).Worksheets(1).Range(A1).Value=1

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
117 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Declarao implcita do WorkBook:


Omitir a referncia ao workbook, semelhante a assumir o workbook activo como
ambiente de trabalho. Neste contexto, as expresses abaixo indicadas assumem por defeito
que se est a trabalhar no Excel, e no workbook que nesse momento estiver activo.

ActiveWorkbook.Worksheets(1).Range(A1).Value=1
Worksheets(1).Range(A1).Value=1

Declarao implcita da WorkSheet:


O mesmo se aplica relativamente s worksheets.

ActiveSheet.Range(A1).Value=1
Range(A1).Value=1

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
118 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Nvel de referncia a privilegiar


Temos aqui representados 7 nveis de codificao:
Ento, se existem tantas formas de referenciar uma clula, qual a forma a previligiar?

Aplication.Workbooks(1).Worksheets(1).Range(A1).Value=1
Workbooks(1).Worksheets(1).Range(A1).Value=1
ActiveWorkbook.Worksheets(1).Range(A1).Value=1
Worksheets(1).Range(A1).Value=1
Activesheet.Range(A1).Value=1
Range(A1).Value=1
Range(A1)=1

O ideal seria escrever na forma completa, mas existem algumas desvantagens:

cdigo muito denso dificuldades em escrever e ler

maior probabilidade de ocorrncia de erros quando no se sabe precisamente o


contexto em que a aplicao vai ser executada perigoso descrever uma path certinha

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
119 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

Miscellaneous

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
120 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications

A INSTRUO WITH
A instruo With permite abreviar referncias a objectos. No faz sentido utiliz-lo quando
se pretende utilizar s uma propriedade ou mtodo, mas quando pretendemos utilizar
bastantes.

Aplicao Prtica

Figura 38 Rotina para demonstrar o manuseamento de objectos sem a instruo With

Ou Ento:

Figura 39 Rotina para demonstrar o manuseamento de objectos com a instruo With

OUTRAS FUNES TEIS DO VBA


______________________________________________________________________________________L
EANDRO ALVES FERREIRA
121 / 122
WROMS@BOL.COM.BR

Excel Macros e Visual Basic for Applications


Abs
CurDir
Date
Exit Do
Exit For
Exit Function
Exit Sub
Fix
Int
Is Array
IsDate
IsEmpty
IsError
IsNull
IsNumeric
IsObject
Len
Now
Shell
Sqr
Str
StrComp
Time
TypeName
Cint
Cbool
Cdate
CLng
CStr

Valor absoluto de um nmero.


Directoria MS-DOS corrente.
Data do sistema.
Interrompe a execuo de uma ciclo Do Loop
Interrompe a execuo de um ciclo For Next ou For
Each Next
Provoca a interrupo da execuo de uma funo.
Provoca a interrupo da execuo de uma sub-rotina.
Arredonda um nmero decimal positivo para baixo, e um
negativo para cima. Ex 3,9 ->3 e 3,9 -> -3
Arredonda para cima um nmero decimal positivo ou
negativo. Ex 3,9 ->4 e 3,9 -> -4
True se a expresso um array. False caso contrrio.
True se a expresso do tipo Date. False caso contrrio.
True se nenhum valor foi atribudo varivel.
True se a expresso contiver um erro.
True se a expresso representar o valor NULL.
True se a expresso for numrica.
True se se tratar de um objecto.
Retorna a dimenso de uma String.
Retorna o valor da data e da hora actual.
Corre um programa executvel.
Retorna a raiz quadrada de um nmero.
Retorna a representao String de um nmero.
Realiza a comparao de strings, produzindo True ou
False conforme sejam ou no iguais.
Produz a hora actual.
Retorna o tipo de dados de uma varivel.
Converte uma expresso de forma numrica ou textual
para um valor de tipo inteiro.
Converte uma expresso de forma numrica ou textual
para um valor de tipo booleano.
Converte uma expresso de forma numrica ou textual
para um valor de tipo data.
Converte uma expresso de forma numrica ou textual
para um valor de tipo Long.
Converte uma expresso de forma numrica ou textual
para um valor de tipo String.

______________________________________________________________________________________L
EANDRO ALVES FERREIRA
122 / 122
WROMS@BOL.COM.BR

You might also like