Júlio Battisti Livros e Cursosa sua sala de aula na internet

Anatomia dos Módulos do VBA

O código VBA é escrito em unidades chamadas subrotinas ou funções que são armazenadas em módulos. Os módulos do Microsoft Access 2007 podem ser de dois tipos:

• Módulos Padrão (Standard modules).
• Módulos de Classes (Class modules).

Módulos padrão: são criados a partir da opção Módulos do banco de dados. Os procedimentos e funções criados neste tipo de módulo podem ser utilizados a partir de outros módulos, em formulários e relatórios. Por exemplo, posso criar um módulo padrão chamado "Funções de Validação". Neste módulo crio uma função para validação do CPF, outra para validação do CNPJ e uma terceira para validação do número de processos. A partir de qualquer formulário ou relatório posso "chamar" as funções contidas no módulo "Funções de Validação". Esta é uma maneira de "reaproveitar" as funções que criamos, ou seja, criamos uma única vez e utilizamos nos vários locais onde a função for necessária.

Módulos de classe: Podem ser criados como Módulos padrão ou podem ser associados a um formulário ou relatório. Ao criarmos código associado com um evento em um formulário ou relatório, o Microsoft Access 2007, automaticamente, cria um módulo associado com o formulário/relatório.

Anatomia de um módulo VBA: Um módulo VBA é formado por uma seção de declarações e uma série de funções/procedimentos. A diferença básica entre  função e procedimento é que a função retorna um ou mais valores e o procedimento simplesmente executa uma série de comandos, sem retornar valores. Na seção de declarações podemos declarar variáveis e outros comandos especiais que terão efeito sobre todos os componentes do módulo.

Quando criamos um módulo associado a um formulário, temos uma série de procedimentos. Cada vez que criamos código em resposta a um evento, é criado um novo procedimento no modo associado ao formulário.
A seguir temos um exemplo de uma estrutura genérica de um módulo.

Observação: As linhas que iniciam com um apóstrofe são linhas de comentário, isto é, não serão executadas pelo Microsoft Access 2007. O uso de comentários é uma forma de fazer a documentação do código VBA, o que facilita a compreensão e manutenção de nossas rotinas.

Agora chegou o momento de estudarmos os principais comandos do VBA

Tipos de dados:

Declaração e “tipo” de variável:

Uma variável é um espaço na memória do computador, reservado para armazenar um ou mais valores. Fazemos referência a este espaço utilizando nomes. Como o valor armazenado pode variar, a medida que o código VBA é executado, estas estruturas são chamadas de variáveis.

No VBA, não é obrigatório a declaração de variáveis. Porém é recomendável que declaremos todas as variáveis, de tal forma que o código fique mais claro e de fácil compreensão. Para declararmos uma variável, utilizamos o comando Dim, conforem exemplificado abaixo:

Dim x
Dim nome
Dim teste

Neste caso estamos apenas declarando o nome da variável, sem declarar de que tipo (texto,inteiro, data, etc) é a variável. Uma variável declarada sem tipo é considerada do tipo Variant, o que na prática significa que a variável pode conter qualquer tipo de valor. Pode parecer uma prática interessante a não declaração do tipo da variável, porém isso é altamente desaconselhável. Se não declararmos o tipo, conforme descrito anteriormente, a variável poderá conter qualquer valor. Neste caso o que impede de um campo numérico conter valores de texto ou vice-versa??

Nota: Para exemplificar os diversos comandos básicos da linguagem VBA, vamos utilizar o formulário Teste. Para cada comando que será exemplificado, criaremos um novo botão de comando e atribuiremos, ao evento Ao clicar do botão, o código do Exemplo. Para facilitar o estudo, nomearemos o botão com um nome relacionado com o exemplo que este representa. Por exemplo, ao criarmos o botão para exemplificar o uso de operadores aritméticos, chamaremos este botão de ExOperAritméticos. Para maiores informações sobre como criar código associado ao evento Ao clicar de um botão, consulte o exemplo anterior:"Para criar o formulário Teste faça o seguinte:"

O formato geral para o comando Dim é:

Dim nome_da_variável As tipo_da_variável

Também podemos declarar mais do que uma variável, com um único comando Dim. Para isto, basta separar as variáveis, com vírgula, conforme exemplificado abaixo:

Dim x,y,z As String
Dim nome as Double
Dim teste1, teste2 As Integer

IMPORTANTE: Observe que definimos o “tipo” de cada variável. O Tipo define quais dados podem ser armazenados em uma variável. Por exemplo, variáveis que armazenam valores numéricos, não devem aceitar caracteres de texto. Variáveis que armazenam datas, não devem aceitar datas inválidas, como por exemplo 30/02/2010. Toda variável no VBScript, é do tipo Variant, isto significa que a variável pode ser de qualquer tipo. O que define o tipo da variável é o valor que está armazenado no momento. Existem funções que conversão de tipo, conforme veremos mais adiante.

Também podemos utilizar variáveis que não foram, explicitamente, declaradas com o comando Dim. Com isso, a variável é criada na memória, no momento da sua utilização. Para fazer com que toda variável tenha que ser, explicitamente, declarada, antes de ser utilizada, devemos utilizar o seguinte comando na seção de declaração do módulo:

Option Explicit

Ao colocarmos este comando na seção de declaração do módulo, estamos definindo que toda variável deve ser declarada, antes de ser utilizada em uma expressão. Se tentarmos utilizar uma variável não declarada, será gerado um erro de compilação. Falaremos mais sobre erros e o tratamento de erros, na terceira semana do treinamento.

Na Listagem 1, temos um exemplo simples de utilização de variáveis não declaradas explicitamente.

Listagem 1 – Utilização de variáveis não declaradas.

Ao tentarmos executar este código, tendo sido definida a opção "Option Explicit", obteremos a mensagem de erro indicada na próxima figura. Este erro acontece porque tentamos utilizar uma variável c, variável esta que não foi declarada.

Figura 141 – Mensagem.

Se você alterar a opção para “Option Compare Database”, a mensagem aparecerá corretamente:

Figura 142 – Option Compare Database.

Figura 143 – Mensagem.

O tipo Variant é formado de pequenas unidades, chamadas subtipos. Cada subtipo, identifica de que maneira os dados são armazenados em uma variável do tipo Variant  Por exemplo, variáveis do subtipo Integer são armazenadas de uma maneira diferente de variáveis do subtipo Long. Na Tabela a seguir temos uma descrição dos principais subtipos.

Tabela - Subtipos do tipo Variant.