Curso VBA Excel

Excel Macros e Visual Basic for Applications(verso Draft)

______________________________________________________________________________________ISCTE / DCTI 1 / [email protected]

ndice

MACROS ......................................................................................................................................................................... 5

O QUE UMA MACRO?................................................................................................................................................ 6CRIAR MACROS............................................................................................................................................................ 6

Gravar uma Macro ................................................................................................................................................. 6Exerccio................................ ................................ ................................ ................................ ................................ 8Procedimento BackGround do Excel ..................................................................................................................... 9

Programao em Visual Basic for Applications.............................................................................................10EXECUTAR UMA MACRO...........................................................................................................................................12

Tecla de Atalho Shortcut Key..........................................................................................................................12Boto na Toolbar..................................................................................................................................................13

Associar uma Macro a um Boto.........................................................................................................................13Dissociar uma Macro de um Boto .....................................................................................................................15

Run...........................................................................................................................................................................16Comando no Menu................................................................................................................................................17

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

Editor de Visual Basic for Applications............................................................................................................20REMOVER MACROS....................................................................................................................................................21

Remoo de Macros em Ambiente Excel..........................................................................................................21Remoo de Macros no Editor de VBA.............................................................................................................21

EDITOR DE VISUAL BAS IC FOR APPLICATIONS....................................................................................22

PROJECT EXPLORER...................................................................................................................................................24PROPERTIES WINDOW................................................................................................................................................26JANELA DE EDIO....................................................................................................................................................27OBJECT BROWSER......................................................................................................................................................28HELP ON-LINE ............................................................................................................................................................28AS CORES DO VBA....................................................................................................................................................29

FUNES E SUBROTINAS ...................................................................................................................................30

SUBROTINAS...............................................................................................................................................................32Definio de SubRotinas.....................................................................................................................................32Trabalhar no Editor de VBA Criar uma SubRotina....................................................................................33Execuo de uma SubRotina...............................................................................................................................34

FUNES......................................................................................................................................................................34Definio de Funes...........................................................................................................................................34Definio do tipo de parmetros e do tipo da funo....................................................................................35Trabalhar no Editor de VBA Criar uma Funo.........................................................................................36Execuo de uma Funo....................................................................................................................................37

Execuo dentro de uma Clula ..........................................................................................................................38Execuo dentro de uma Rotina ..........................................................................................................................40

DIFERENAS ENTRE FUNES E ROTINAS..............................................................................................................42REGRAS PARA A PASSAGEM DE PARMETROS........................................................................................................42



VARIVEIS ..................................................................................................................................................................43

MANUSEAMENTO COM VARIVEIS..........................................................................................................................44O que so variveis?............................................................................................................................................44Assignao de valores a variveis: ...................................................................................................................45Utilizao de variveis como se fossem valores: ............................................................................................45

TIPOS DE VARIVEIS ..................................................................................................................................................46DECLARAO DE VARIVEIS...................................................................................................................................47VARIVEIS VANTAGENS DA UTILIZAO............................................................................................................47VARIVEIS DO TIPO OBJECTO..................................................................................................................................48

Declarao da Varivel Objecto........................................................................................................................48Atribuio de uma varivel Objecto..................................................................................................................48Utilizao Genrica da Varivel Objecto........................................................................................................49Utilizao Especifica da Varivel Objecto ......................................................................................................49

VARIVEIS DECLARAO OPCIONAL E O TIPO VARIANT .................................................................................51Os Prs e Contras da Utilizao do tipo Variants .........................................................................................51

Prs......................................................................................................................................................................51Contras.................................................................................................................................................................51

Variveis Declarao Forada.......................................................................................................................52VARIVEIS TIPOS DEFINIDOS PELO UTILIZADOR - ESTRUT URAS.......................................................................53

Definio do Tipo .................................................................................................................................................53Utilizao das Estruturas de Dados..................................................................................................................54

VARIVEIS ARRAYS ...............................................................................................................................................55O que um Array ? ..............................................................................................................................................55

Array Uni-Dimensional .......................................................................................................................................55Array Bi-Dimensional ................................ ................................ ................................ ................................ .........56

Declarao de um array......................................................................................................................................57Arrays Uni-dimensionais .....................................................................................................................................57Arrays Bi-dimensionais .......................................................................................................................................57

Utilizao de um Array........................................................................................................................................58Para aceder ao elemento......................................................................................................................................58Atribuio de valores ...........................................................................................................................................58

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

CONSTANTES .............................................................................................................................................................60

O QUE SO CONSTANTES ? ........................................................................................................................................61

INPUTBOX E MSGBOX ..........................................................................................................................................62

O QUE SO ?................................................................................................................................................................63INPUT BOX...................................................................................................................................................................63

O que faz.............................................................................................................................................................63Sintaxe.....................................................................................................................................................................63Parmetros.............................................................................................................................................................64

MSGBOX......................................................................................................................................................................65O que faz.............................................................................................................................................................65Sintaxe.....................................................................................................................................................................65Parmetros.............................................................................................................................................................66Valores Produzidos...........................................................................................................................................69

DOMNIO DAS VARIVEIS, CONSTANTES E ROTINAS........................................................................70

O QUE O DOMINIO?..................................................................................................................................................71DOMNIO DAS VARIVEIS.........................................................................................................................................71

mbito do Procedimento .....................................................................................................................................72mbito do Mdulo................................................................................................................................................73mbito do Projecto...............................................................................................................................................74

DOMNIO DAS CONSTANTES.....................................................................................................................................75mbito do Procedimento .....................................................................................................................................75



mbito do Mdulo................................................................................................................................................76mbito do Projecto...............................................................................................................................................76

DOMNIO DE SUBROTINAS E FUNES...................................................................................................................77

ESTRUTURAS DE CONTROLO ..........................................................................................................................78

O QUE SO ESTRUTURAS DE CONTROLO ?...............................................................................................................79QUAIS AS ESTRUTURAS.........................................................................................................................................79IF-THEN-ELSE.............................................................................................................................................................80

Funo IF do Excel ..............................................................................................................................................80Sintaxe da Estrutura If-Then-Else......................................................................................................................80Aplicao Prtica .................................................................................................................................................81A instruo adicional ElseIf...............................................................................................................................83

Aplicao Prtica .................................................................................................................................................83FOR NEXT.................................................................................................................................................................84

Sintaxe.....................................................................................................................................................................84Aplicao Prtica .................................................................................................................................................84

A Funo das Variveis: ......................................................................................................................................85Construo do Ciclo: ...........................................................................................................................................85Traduo Integral.................................................................................................................................................86

Funcionamento do Ciclo:....................................................................................................................................86Perigos associados utilizao do ciclo For-Next:.......................................................................................86Outra Aplicao....................................................................................................................................................87

WHILE-WEND.............................................................................................................................................................88Sintaxe.....................................................................................................................................................................88Aplicao Prtica .................................................................................................................................................88

A Funo das Variveis: ......................................................................................................................................89Construo do Ciclo: ...........................................................................................................................................89Traduo Integral.................................................................................................................................................90

Funcionamento do Ciclo .....................................................................................................................................90Perigos associados utilizao do ciclo While-Wend...................................................................................90Outra Aplicao....................................................................................................................................................91

DO LOOP...................................................................................................................................................................92Sintaxe.....................................................................................................................................................................92Aplicaes Prticas..............................................................................................................................................93

SELECT CASE ..............................................................................................................................................................95Sintaxe.....................................................................................................................................................................95Aplicao Prtica .................................................................................................................................................96

Construo da Estrutura.......................................................................................................................................97FOR EACH NEXT...................................................................................................................................................98

Sintaxe.....................................................................................................................................................................98Aplicaes Prticas..............................................................................................................................................99

Utilizando Arrays.................................................................................................................................................99Construo do Ciclo...................................................................................................................................... 100

Utilizando Coleces de Objectos..................................................................................................................... 101

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

O QUE SO OBJECTOS ?...........................................................................................................................................103OBJECTOS: PROPRIEDADES, MTODOS E EVENTOS............................................................................................103

Propriedades ...................................................................................................................................................... 103Mtodos............................................................................................................................................................... 103Eventos................................................................................................................................................................. 104

OBJECTOS MAIS UTILIZADOS NO EXCEL...............................................................................................................105Propriedades ...................................................................................................................................................... 105Mtodos............................................................................................................................................................. 106Propriedades ...................................................................................................................................................... 107Mtodos............................................................................................................................................................. 108Propriedades ...................................................................................................................................................... 109



Mtodos............................................................................................................................................................. 110Propriedades ...................................................................................................................................................... 111Mtodos............................................................................................................................................................. 112

OBJECTOS SINGULARES VS COLECES DE OBJECTOS..........................................................................113INDEXAO DE COLECE S POR NMERO OU NOME..........................................................................................114

Indexao com Base em Nmeros.................................................................................................................. 114Indexao com Base no Nome ......................................................................................................................... 115

Vantagem........................................................................................................................................................... 115O Objecto Range uma excepo.................................................................................................................. 116

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

REFERNCIA IMPLCITA...........................................................................................................................................117Declarao implcita da aplicao:............................................................................................................... 117Declarao implcita do WorkBook:.............................................................................................................. 118Declarao implcita da WorkSheet:............................................................................................................. 118Nvel de referncia a privilegiar..................................................................................................................... 119

MISCELLANEOUS ................................................................................................................................................. 120

A INSTRUO WITH.................................................................................................................................................121Aplicao Prtica .............................................................................................................................................. 121

OUTRAS FUNES TEIS DO VBA ........................................................................................................................122



MMaaccrrooss



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 MACROSExistem 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.



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 serimportante 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 emreferncias 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.



EXERCCIOObjectivo: Gravar uma macro testando a diferena entre a execuo de macros com referncias absolutas e relativas.

1 Fase: Macro com referncias Absolutas

1. Accione a gravao da macro. Atribua-lhe o Short Key Ctrl+P2. Certifique-se que o boto Relative Reference est desactivado.3. Clique na clula B3.4. Escreva ISCTE5. Formate a clula para Bold, Itlico, tamanho 18, Small Caps, (utilize o Format /

Font)6. Na clula B4 escreva: Av. Foras Armadas7. Na clula B5 escreva: 1700 Lisboa8. 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 P12. O que aconteceu ?

2 Fase: Macro com referncias Relativas

1. Seleccione a clula D5.2. Accione a gravao da macro. Atribua-lhe o Short Key Ctrl+R3. Seleccione o boto Relative Reference.4. Escreva ISCTE na clula que havia sido seleccionada.5. Formate a clula para Bold, Itlico, tamanho 18, Small Caps, (utilize o Format /

Font)6. Na clula D6 escreva: Av. Foras Armadas7. Na clula D7 escreva: 1700 Lisboa8. 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 R12. O que aconteceu ? Porqu ?



PROCEDIMENTO BACKGROUND DO EXCELO 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.



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:

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 suafuncionalidade 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 odesenvolvimento 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 , 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 dosobjectos seleccionados.

6.4. Seleccione um dos objectos e visualize do lado direito os Members of

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.



EXECUTAR UMA MACROA 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.



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



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 ( ve r operaesseguintes).

Fig.5 Menu para configurao do boto da toolbar



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 opodesignada 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 nomeassociado 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 imagemdiferente, 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 BOTO1. Tools / Customize2. Arraste o boto da toolbar at ao documento3. Solte-o



Run


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



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 :

a) Seleccionar a categoria New Menub) Na rea dos Commands ser exibida a opo New Menu, que dever arrastar at

barra dos menusc) Poder alterar o seu nome clicando no boto de Modify Selectiond) 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)



DISSOCIAO1. Tools / Customize

2. Arraste o Menu ou Comando do Menu at ao documento e solte-o



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



REMOVER MACROSA remoo das macros poder ser feita:

no ambiente Excel, ou no Editor de VBA

Remoo de Macros em Ambiente Excel


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)



EEddiittoorr ddee VViissuuaallBBaassiicc ffoorr

AApppplliiccaattiioonnss



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.



PROJECT EXPLORERSe 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 Applicationsactivos 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



Assim se fizer o desdobramento do seu VBAProject, encontrar um folder cujadesignao 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 deWorkSheets). 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.



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.



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



OBJECT BROWSER

No Editor de Visual Basic for Applications poder encontrar ajuda para odesenvolvimento do seu procedimento. Assim:

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

Na Caixa de Drop-Down onde aparece referido , seleccione aaplicao 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 omanuseamento da aplicao seleccionada. A classe especial designada por Globals refere-se s funes que esto disponveis na aplicao independentemente dosobjectos seleccionados.

Seleccione um dos objectos e visualize do lado direito os Members of

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-LINEO 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.



AS CORES DO VBANa 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 alteradaspara letras maisculas ou minsculas, conforme esteja pr-definido.

Preto Nome de variveis, procedimentos, valores, operadores,

Verde Comentrio introduzidos no seio dos procedimentos. Estescomentrios servem para o utilizador poder associar algumasexplicaes aos procedimentos realizados. De referir que as palavras com esta cor so ignoradas no procedimento, i.e., no produzemqualquer 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 qualdetectou 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.



FFuunneess eeSSuubbRRoottiinnaass



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 comoobjectivo 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.

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



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 ( )

End Sub

Estas SubRotinas so designadas pelo nome 2 que lhe atribumos e no recebemparmetros3 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.

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

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



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

4 Nomes alternativos para fazer referncia a um conjunto de instrues.



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.

FUNESDefinio 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 ( , ,)

=

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.



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 ( As , ) As

=

End Function

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



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



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



EXECUO DENTRO DE UMA CLULA

1. Posicione-se na clula onde pretende inserir a funo2. Insert / Function3. 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



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

= ( , )



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:

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



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.



VVaarriivveeiiss



MANUSEAMENTO COM VARIVEIS

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:

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.

=

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 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 se m 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.79769313486232E308at -4.94065645841247E-324 para valores negativos, e desde1.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 at1.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



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 utilizarAs palavra chave utilizada para separar o nome da varivel do tipo de dadosInteger 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



VARIVEIS DO TIPO OBJECTOUma varivel objecto representa uma referncia a um objecto. Uma varivel de extrema importnc ia que facilita a codificao e melhora a performance da subrotina.

Declarao da Varivel Objecto

Dim As Object

Atribuio de uma varivel Objecto

Set =

Onde:

Set palavra chave que indica a assignao de uma varivel objecto - Varivel Objecto= - Operador de assignao

- Objecto a ser atribudo varivel



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 ObjectRange_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 tipoespecifico de objectos coincide com o nome dos objectos em EXCEL.

Dim Range_1 As RangeDim WB_1 As WorkbookDim WS_1 As WorkSheet

Dim XL As Aplicativo

Exemplo:

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



Contudo estas declaraes tambm podem ser feitas da seguinte forma genrica:

Dim Range_1 As ObjectDim WB_1 As ObjectDim WS_1 As ObjectDim 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.



VARIVEIS DECLARAO OPCIONAL E O TIPO VARIANTA 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.



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 DeclarationOu 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



VARIVEIS TIPOS DEFINIDOS PELOUTILIZADOR - ESTRUTURAS

Definio do Tipo

A primeira fase constituda pela definio do tipo:

Type Dados_Pessoais

Nome As StringIdade As IntegerDataNascimento As DateBI 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.



Utilizao das Estruturas de Dados

Como utilizar as estruturas de dados:

Sub Tipos_definidos_Utilizador()

Dim Pessoa As Dados_Pessoais

Pessoa.Nome = FranciscoPessoa.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

5 Ver captulo InputBox e MsgBox



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-DIMENSIONAL012345

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.



ARRAY BI-DIMENSIONAL

0 1 20123

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.



Declarao de um array

ARRAYS UNI-DIMENSIONAISDim 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_Numerico0123456789

Em que cada elemento do tipo Integer.

ARRAYS BI-DIMENSIONAISDim 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_Textual0 1 2

0123



Utilizao de um Array

PARA ACEDER AO ELEMENTO([,, ])

ATRIBUIO DE VALORES([,, ]) =

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 0Brasil 1Moambique 2

Valor estes que sero exibidos atravs da MsgBox.



Exemplo 2:Option Base 1Sub 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



CCoonnssttaanntteess



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 As = Const As =

Figura 23 Manuseamento de Constantes



IInnppuuttBBooxx eeMMssggBBooxx



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 ava liao da funo, pode-se dizer que a mesma possui diversosparmetros, mas somente o primeiro obrigatrio, sendo que todos os outros quando ignorados assumem valores atribudos por defeito.



ParmetrosParmetro Comentrio

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 nd ice 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.



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.



Parmetros

Parmetro Comentrio

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)

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.



Constante de VBA Valor Descrio

VbOKOnly 0 Exibe somente o boto de OK.VbOKCancel 1 Exibe os botes OK e Cancel.VbAbortRetryIgnore 2 Exibe os botes Abort, Retry, e Ignore.VbYesNoCancel 3 Exibe os botes Yes, No, e Cancel .VbYesNo 4 Exibe os botes Yes e No.VbRetryCancel 5 Exibe os botes Retry e Cancel.VbCritical 16 Exibe o cone de Critical Message. VbQuestion 32 Exibe o cone de Warning Query.VbExclamation 48 Exibe o cone de Warning Message.VbInformation 64 Exibe o cone de Information Message.VbDefaultButton1 0 O primeiro boto o seleccionado por defeito.VbDefaultButton2 256 O segundo boto o seleccionado por defeito.VbDefaultButton3 512 O terceiro boto o seleccionado por defeito.VbDefaultButton4 768 O quarto boto o seleccionado por defeito.VbApplicationModal 0 Application modal o utilizador s depois de responder

MsgBox que poder dar continuidade ao trabalho na aplicao corrente.

VbSystemModal 4096 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:

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



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 Valor Boto Accionado

vbOK 1 OKvbCancel 2 CancelvbAbort 3 AbortvbRetry 4 RetryvbIgnore 5 IgnorevbYes 6 YesvbNo 7 No



DDoommnniioo ddaassvvaarriivveeiiss,,

ccoonnssttaanntteess eerroottiinnaass



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 VARIVEISRefere-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.



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 automaticamentedestrudas quando o procedimento termina, sendo que s so reconhecidas no seio do procedimento que as declarou. Assim sendo, qualquer tentativa realizada por umprocedimento no sentido de trabalhar com variveis definidas no corpo de um outro procedimento no ter xito.

Exemplo

Sub Ambito_Procedimento()Dim Var_1 As IntegerVar_1 = InputBox (Introduza um nmero Inteiro)MsgBox Foi este o nmero que introduziu: & Var_1Ambito_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 ProcedimentoAmbito_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.



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 Dimna 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.



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 oprocedim

Documents

Curso VBA Excel