VBA Word - Declarando variáveis
 |
| VBA Word - Declarando Variáveis Origem da imagem: Ozai.com.br |
Olá, como vocês estão?!
Dando continuidade aos nossos estudos sobre VBA Word,
veremos o conceito de variáveis, registraremos como são criadas as variáveis,
quais tipos existem e como declará-las utilizando a linguagem VBA.
As variáveis são espaços reservados
de memória para guardar informações, como se fossem gavetas, quando criamos uma
variável, é como se criássemos uma gaveta para armazenar uma informação com o
propósito de acessá-la sempre que necessário em nossa aplicação. Ao nomear uma
variável devemos seguir as seguintes regras:
·
Não são permitidos: espaços, vírgulas, pontos,
pontos de exclamação ou
caracteres especiais (%, #, $, @,
&, etc);
·
Não utilizar palavras que já são utilizadas pelo
sistema, as conhecidas palavras proibidas, exemplo: Dim, Range, Document,
thisDocument, Paragraphis, Object, Integer, dentre outras;
·
O nome deve ser menor que 255 caracteres;
·
Os nomes devem iniciar especificamente com
letras.
Tipos
de variáveis
Os tipos das variáveis são os
gêneros das informações que necessitamos armazenar em memória, de acordo com o
tipo temos uma quantidade de memória equivalente, por isso é necessário
interpretar qual informação será armazenada para evitar consumos excessivos de
memória:
|
Tipo |
Espaço ocupado |
Descrição |
|
Boolean |
2 bytes |
Valores Booleanos True ou False |
|
Byte |
1 Byte |
Números sem sinal entre 0 e 255 |
|
Currency |
8 bytes |
Moeda |
|
Date |
8 Bytes |
Datas |
|
Double |
8 Bytes |
Real De 1.79769313486232E308 |
|
Single |
4 Bytes |
Real desde 3.402823E38 até 1.4011298E- |
|
Integer |
2 bytes |
inteiros entre -32.768 e 32767 |
|
Long |
4 Bytes |
entre -2 147 483 648 e |
|
Object |
4 bytes |
referência a um objeto do Word |
|
String |
1 byte |
conjuntos de caracteres |
|
Variant |
16 bytes |
qualquer tipo de dados |
|
User-Defined |
---- |
tipos diferentes |
Para acompanhar os exemplos a seguir
abra um documento do Word, clique em salvar como, escolha um diretório para
salvar o arquivo, em tipo, escolha a opção “Documento Habilitado para Macro do
Word”, com extensão .docm e clique no botão salvar:
Na área de trabalho, crie um
procedimento da seguinte forma:
Public Sub teste()
Dim num As Integer
num = 20
Debug.Print (num)
End Sub
Na declaração acima “Dim” é uma palavra reservada, utilizada
para informar ao sistema que uma variável está sendo declarada, “num” é a
referência a variável que criamos, poderíamos criar qualquer nome, seguindo as
regras para nomear variáveis é claro, o termo “as Integer” refere-se ao tipo de
variável, nesse caso escolhemos uma variável do tipo inteiro.
A função “Debug.Print()” é usada para “debugar” o código,
nesse procedimento, caso executado vai retornar o resultado da variável “num”
na “Janela de Verificação Imediata”, caso essa janela não esteja aparecendo
para você clique no menu “Exibir” e ligue a “Janela de Verificação Imediata”,
como nas imagens a seguir:
É possível declararmos, várias variáveis em mesma linha,
veja:
Dim num1 As Integer, data_inicio As
Date, num3 As Double
Para facilitar ainda mais o trabalho, podemos declarar
várias variáveis do mesmo tipo da seguinte forma:
Dim num1, num2, num3 As Integer
Faça testes utilizando a função
“Debug.Print()” e a “Janela de Verificação Imediata”, para executar a macro
clique no botão executar macro, ou use a tecla de atalho “F5”, como na imagem a
seguir:
Variáveis do tipo Objeto
Os documentos do Microsoft Office
são organizados por objetos, esses objetos facilitam o trabalho, pois otimizam
o código facilitando a referenciar partes do sistema para modificarmos
propriedades e acessar métodos específicos para implementações.
Possuímos, por exemplo, os
objetos Range, Documents, dentre outros. Não se preocupem com isso por
enquanto, posteriormente acessaremos objetos para acessar suas propriedades,
veremos que é fácil e intuitivo. Por enquanto, apenas entenda que é possível
acessá-los se os referenciarmos em variáveis. Veja a sintaxe:
Dim objTeste as Object
Set obj = <Nome_do_objecto>
Como já mostramos acima, “Dim” é
uma palavra reservada para indicar a atribuição de uma variável, “objTeste” é o
nome que atribuímos como referência para a variável, iremos utilizá-lo para
acessá-la, “as Object” indica o tipo da variável como objeto, marca que estamos
referenciado um objeto daquele aplicativo específica, em nosso caso do Word,
mas poderia ser de qualquer aplicativo do Microsoft Office.
Após declarar a variável é
preciso atribuir um valor a ela, por isso o operador “=”, que faz esse papel de
atribuir valor a uma variável. A palavra reservada “Set” é utilizada para “setar”
qual objeto da aplicação estará referenciado pela variável, é utilizado
especificamente para objetos. Onde está <Nome_do_objecto > é o nome do
objeto específico, pode ser Application, Documents, Range, dentre outros. Posteriormente
veremos alguns objetos que poderão ser acessados.
Uma
variável com tipo declarado, tem seu processamento mais rápido, ocupa menos
espaço em memória, tem sua função específica definida e otimiza a execução da
aplicação. Quando não definimos o tipo da variável ela assume o tipo de
Variant, o sistema tem que fazer essa conversão, esse procedimento também
aumenta o tempo de execução do sistema. Portanto deve ser utilizado somente
quando a mudança for intencional.
Forçando a declaração de variáveis
Em algumas situações precisamos
que todas as variáveis criadas no sistema sejam corretamente tipadas e declaradas.
Para isso inserimos no início do código o termo “Option Explicit” no início do
módulo. Outra forma de fazermos esse procedimento de forma automática, é só
selecionar o módulo ir ao Menu Ferramentas/ Opções.../ na guia Editor/ selecione
Requerer
declaração de variável. Pronto, a expressão “Option Explicit” será colocada no
início do módulo.
Com essa ação todas as variáveis
precisarão ser declaradas, isso evita a criação acidental de variáveis, ações
que podem prejudicar o desempenho da aplicação, caso a variável não seja
declarada um erro será emitido pelo sistema.
Conclusão
Nesse
estudo aprendemos o que são variáveis, vimos diferentes formas de declará-las,
quais são os seus tipos e como obrigar a declaração delas. Fizemos alguns
testes com o Editor do VBA e “debugamos” os valores das variáveis por meio da
função Debug.Print() e a Janela de Verificação Imediata. Então fica aqui mais
um registro de estudo, até a próxima.
Comentários
Postar um comentário