Adicionando
refer�ncias dinamicamente no
|
|
|
N� Vers�o |
|
Microsoft |
8.0 |
|
Microsoft |
9.0 |
|
Microsoft |
10.0 |
|
Microsoft |
11.0 |
Como estou
fazendo este aplicativo na vers�o 2003, a biblioteca referenciada
ser� a Microsoft
![]()

Figura 2: Refer�ncias do aplicativo
Agora, insira um m�dulo convencional indo ao menu Inserir->M�dulo. Nesse m�dulo, coloque o seguinte c�digo:
|
Public Sub AbreWord()
Dim
versao
As
String End Sub |
Se a refer�ncia
estiver sido feita corretamente. ser� poss�vel usufruir dos recursos
do Intellisense para escrever o c�digo. No

Figura 3: Arquivo de
A Macro pegou a
vers�o do
Com a Macro
funcionando, vamos agora test�-la em outra vers�o do

Figura 4: Executando a Macro
Se tudo der certo (ou errado), surgir� a seguinte mensagem:

Figura 5: Erro gerado pela Macro executada no
Clique em OK e veja que o editor parou a execu��o do c�digo na
linha em declaramos o Objeto
![]()

Figura 6: Vericando a linha de erro da Macro
Verifique as
refer�ncias feitas inda � caixa de di�logo de refer�ncias
(Ferramentas->Refer�ncias o
![]()

Figura 7: Vericando a aus�ncia da refer�ncia
Para resolver o
problema de funcionamento da Macro, bastaria desfazer essa
refer�ncia e procurar a Microsoft

Figura 8: Arquivo de
Veja que o texto
gerado dinamicamente pela Macro obedeceu ao crit�rio de vers�o e
alterou o n�mero colocado no texto (Se executar a Macro no
Neste ponto, chegamos a algumas conclus�es e solu��es para o problema:
Desenvolver
sempre numa vers�o mais antiga para garantir o funcionamento em
qualquer vers�o do
O problema � que limitar�amos aos recursos de uma vers�o mais antiga al�m do fato de se a o aplicativo for aberto em alguma vers�o superior e for salvo, ele manter� a refer�ncia da �ltima vers�o do aplicativo em que foi aberto provocando novamente o problema de versionamento.
Ter
instalada todas as vers�es do
Talvez desse certo, mas quem se disponibiliza tanto financeiramente como em recursos de m�quina e conflitos gerados a ter instalada todas as vers�es do aplicativo?
Cria e manter a refer�ncias dinamicamente?
Essa creio eu ser a melhor sa�da. N�o � completamente infal�vel, mas j� testei em v�rios ambientes e se comportou muito bem.
Como adicionar as refer�ncias via c�digo
Al�m dos
conceitos de seguran�a e permiss�es discutidos no come�o do artigo,
� preciso se acostumar um pouco com os elementos das refer�ncias.
Para que a manipula��o funcione, � preciso fazer refer�ncia �
bilbioteca Microsoft
Vamos fazer um
exemplo que use objetos dessa biblioteca. Insira um m�dulo
convencional na mesma planilha que fizemos anteriormente no
|
Public Sub ChecaReferencias()
Dim mensagem
As
String
'Seta a vari�vel para o
projeto da pasta de trabalho ativa.
'Checa as refer�ncias
selecionadas (veja na caixa de di�logo Refer�ncias) End Sub |
Execute a Macro. N�o se esque�a de adicionar a refer�ncia � biblioteca de manipula��o, como dito anteriormente. O resultado dever� ser algo parecido com este:

Figura 9: Resultado gerado pela Macro ChecaReferencias
Voc� pode fazer
uma equival�ncia do resultado desta Macro abrindo a caixa de di�logo
Refer�ncias do
![]()

Figura 10: Verificando as refer�ncias
Teoricamente est� tudo OK. Com esse c�digo, podemos saber e aprender mais sobre as refer�ncias e seus atributos. Modifique a linha de c�digo que monta a mensagem para o seguinte:
|
mensagem = mensagem & "Nome: " & chkRef.Name & " - Caminho: " & chkRef.FullPath & " - Descri��o: " & chkRef.Description & Chr(13) |
Execute a Macro desta vez. O resultado deve ser o seguinte:

Figura 11: Resultado gerado pela Macro ChecaReferencias com a mensagem alterada
Agora temos uma
forma simples de obter mais informa��es sobre as refer�ncias com que
trabalhamos no
A propriedade IsBroken retorna False se a refer�ncia estiver OK e True se estiver quebrada, por exemplo, quando a caixa de di�logo acusa que a refer�ncia est� AUSENTE, � um caso em que o IsBroken retornar� True. Isso nos ajuda a verificar a exist�ncia de uma refer�ncia que nos disponibiliza determinada funcionalidade, por exemplo, uma .OCX que contenha um controle ActiveX como o Calendar Control. Dependendo do resultado, voc� pode optar por rodar ou n�o o projeto.
A propriedade GUID retorna o identificador �nico para a refer�ncia. Para ver esta identifica��o, modifique a linha de c�digo que monta a mensagem para o seguinte:
|
mensagem = mensagem & "Nome: " & chkRef.Name & " - GUID: " & chkRef.GUID & " - Major: " & chkRef.Major & " - Minor: " & chkRef.Minor & Chr(13) |
Veja o resultado:

Figura 12: Resultado gerado pela Macro ChecaReferencias com a mensagem alterada
Com alguma pesquisa, pude confirmar que esse identificador � o mesmo independente de vers�o. Se voc� testar em qualquer outra vers�o o mesmo c�digo, ver� que os GUIDs n�o ser�o alterados. � essa propriedade que usaremos para adicionar e remover as refer�ncias em nossos aplicativos. As propriedades Major e Minor n�o requerem maiores estudos e ser�o usadas somente para a execu��o do m�todo que adiciona a refer�ncia, conforme veremos a seguir.
Os m�todos utilizados para adicionar e remover refer�ncias s�o o AddFromGUID, AddFromFile e Remove.
O m�todo
AddFromFile adiciona a refer�ncia com base no caminho do arquivo. �
uma op��o, mas pode ser problem�tica, pois precisar�amos saber qual
o diret�rio em que foi instalado o aplicativo, o que � vezes pode
ser um mist�rio. Para contornar a situa��o, podemos usar o m�todo
Application.Path que retorna o diret�rio em que foi instalado o
O m�todo AddFromGUID adiciona a refer�ncia com tr�s par�metros: GUID, Major e Minor, que s�o as propriedades discutidas anteriormente. O GUID pode ser passado como String e as vari�veis Major e Minor devem ser passadas como Long.
Pegar os dados
requer c�digo como fizemos anteriormente. Com isso, temos para a
biblioteca Microsoft
GUID:
{00020905-0000-0000-C000-000000000046}
Major: 8
Minor: Depende da vers�o.
A vari�vel Minor
possui um valor que varia conforme a vers�o do aplicativo. Para
regularizar esse valor, a melhor maneira que encontrei foi pegando o
valor do Application.Version. A diferen�a entre os dois
valores � sempre de 8 unidades, portanto podemos fazer uma analogia
para determinar o valor do par�metro. Veja a diferen�a do resultado
da Macro ChecaReferencias executada no

Figura 13: Resultado gerado pela Macro ChecaReferencias no

Figura 14: Resultado gerado pela Macro ChecaReferencias no
O m�todo Remove remove a refer�ncia em si. � preciso passar uma vari�vel do tipo Reference para que funcione.
Tendo visto todas
estas op��es, consegui chegar � seguintes solu��es para nosso
problema. Abaixo proponho um modelo de c�digo que pode tornar o
aplicativo
|
Public Sub AdicionaReferenciaWord()
'Faz a refer�ncia ao projeto
'Seta a vari�vel para o
projeto da pasta de trabalho ativa.
'Pega a vers�o atual do
'Adiciona a refer�ncia do End Sub Public Sub RemoveReferenciaWord()
'Faz a refer�ncia ao projeto
'Seta a vari�vel para o
projeto da pasta de trabalho ativa.
For
Each chkRef
In vbProj.References End Sub |
Insira esse
c�digo em um m�dulo vazio de uma na planilha em que estamos
trabalhando adicionando a refer�ncia ao Microsoft
|
Private
Sub Workbook_BeforeClose(ByVal
Cancel As
Boolean)
Private
Sub Workbook_Open() |
Agora, feche a
planilha e salve no
Voc� pode tamb�m fazer implementa��es com o m�todo AddFromFile, embora em testes eu tenha conclu�do que o AddFromGUID � mais eficiente e menos sujeito e erros.
As fun��es e
recursos oferecidos pela biblioteca Microsoft
Conclus�o
Procurei explanar de maneira enxuta um meio para resolver o problema de versionamento e aus�ncia de componentes que em muito nos auxiliam e azucrinam no desenvolvimento de nossas solu��es.
Download da planilha com os c�digos de exemplo
Refer�ncias
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vbaac11/html/acprominor.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vbaac11/html/acproMajor.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vbext98/html/vamthaddfromguid.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vbext98/html/vamthaddfromguid.asp