Compartilhar via


Guia do usuário do Microsoft Office Code Compatibility Inspector

 

Aplica-se a: Office 2010

Tópico modificado em: 2012-01-27

O Microsoft Office Code Compatibility Inspector ajuda você a solucionar problemas de compatibilidade em suas Macros e suplementos de VBA (Microsoft Visual Basic for Application).

Use o Microsoft Office Code Compatibility Inspector para inspecionar o código VBA criado nas versões anteriores do Microsoft Office e para ajudá-lo a fazer quaisquer chamadas de API (Interface de Programação de Aplicativo) do Windows em seu código compatível com a edição de 64 bits do O Microsoft Office 2010.

Neste artigo:

  • Sobre o inspetor

  • Instalação

  • Inspecionando o código VBA

  • Inspecionando o código VSTO

  • Usando o inspetor

  • Recursos adicionais

Sobre o inspetor

O Microsoft Office Code Compatibility Inspector foi desenvolvido para ajudar uma organização ou pequena empresa a atualizar o código VBA (Visual Basic for Applications) e o código do Visual Studio Tools for Office para que ele fique compatível com o Office 2010. O Inspetor não corrige o código; ele o inspeciona e comenta linhas específicas do código que fazem referências a itens no modelo de objeto que tenham sido alterados ou preteridos. No código VBA, a ferramenta também comenta as declarações Declare para compatibilidade com 64 bits. Você pode modificar o código com base nos comentários ou usar os links apresentados nesses comentários para exibir os tópicos na Web pertinentes a determinada linha do seu código.

Novamente, cabe a você modificar o código se achar necessário.

Veja a seguir os principais recursos do Office Code Compatibility Inspector:

  • Consiste em quatro suplementos que são carregados, um suplemento por aplicativo, no Excel 2010, no PowerPoint 2010, no Word 2010 e no Visual Studio 2008.

  • É executado por usuário ou por documento. Para o VBA, os usuários abrem um documento e executam a ferramenta na guia Desenvolvedor. Para projetos do Visual Studio, o desenvolvedor executa a ferramenta através do menu Ferramentas.

  • Verifica os projetos no documento atual ou na Solução do Visual Studio, usando a pesquisa de texto simples e procurando pelas combinações parentObject.Property, e verifica as declarações Declare para compatibilidade com 64 bits (no VBA).

  • Adiciona comentários nas partes do código em que encontra outros possíveis problemas.

  • Exibe um resumo e um relatório detalhado de tudo o que encontrou após o término da inspeção.

Não é possível usar essa ferramenta para inspecionar código do Microsoft Outlook ou do Microsoft Access. No entanto, é possível usar a ferramenta para inspecionar código do Excel, do PowerPoint e do Word para interação com o modelo de objeto do Outlook.

Instalação

Para instalar o Office Code Compatibility Inspector, siga estas etapas:

  1. Baixe a versão Atualização 1 do OCCI em Ferramenta do Office 2010: Compatibility Inspector (em inglês) (https://go.microsoft.com/fwlink/?linkid=171093\&clcid=0x416) (em inglês). Salve-a na área de trabalho ou em algum outro local conveniente, procure pelo arquivo e clique duas vezes sobre ele para iniciar a instalação.

    • Você pode optar por instalar somente o suplemento do Visual Studio.

    • Você pode optar por instalar somente os suplementos do Office.

    • Se preferir, é possível instalar os dois.

  2. Siga os prompts e clique em Concluir para concluir a instalação.

Exibindo a guia Desenvolvedor

Para cada aplicativo do Office no qual você planeja usar a ferramenta, siga este procedimento:

  1. Abra o Excel 2010, o PowerPoint 2010 ou o Word 2010, se já não estiver aberto.

  2. Na guia Arquivo, clique em Opções.

  3. Selecione Personalizar Faixa de Opções.

  4. Em Escolher comandos em, na lateral esquerda da caixa de diálogo, selecione Comandos Mais Usados.

  5. Em Personalizar a Faixa de Opções, na lateral direita da caixa de diálogo, selecione Guias Principais e marque a caixa de seleção Desenvolvedor.

  6. Clique em OK.

Habilitar acesso ao projeto do VBA

Para cada aplicativo do Office no qual você planeja usar a ferramenta, siga este procedimento:

  1. Abra o Excel 2010, o PowerPoint 2010 ou o Word 2010, se já não estiver aberto.

  2. Na guia Arquivo, clique em Opções.

  3. Clique em Central de Confiabilidade.

  4. Clique em Configurações da Central de Confiabilidade.

  5. Na guia Configurações de Macro, selecione Confiar no acesso ao modelo de objeto do projeto do VBA.

Inspecionando o código VBA

Para inspecionar a compatibilidade de um documento, siga estas etapas:

  1. Abra o documento no Excel 2010, PowerPoint 2010 ou Word 2010.

  2. Na guia Desenvolvedor, clique em Inspecionar Código VBA.

    Figura 1. Opções do Code Compatibility Inspector na guia Desenvolvedor

    Opções do Inspetor na guia Desenvolvedor

  3. Na caixa de diálogo Inspecionar Projeto VBA, marque ou desmarque as opções, conforme apropriado, e clique em Inspecionar.

    Figura 2. Caixa de diálogo Inspecionar Projeto VBA

    Caixa de diálogo Inspect VBA Project (Inspecionar Projeto VBA)

    1. Selecione Inspecionar Projetos do Visual Basic for Application para inspecionar no projeto VBA itens do modelo de objeto que foram alterados ou removidos.

    2. Selecione Inspecionar instruções Declare se o projeto for executado apenas no Office 2010 ou se ele puder ser executado em um sistema com o Office 2010 de 64 bits.

    3. Selecione Adicionar comentários para colocar comentários em seu código onde a ferramenta identificar potenciais problemas de compatibilidade. Os comentários adicionados pelo Inspetor são semelhantes ao exemplo a seguir.

      '<VBA_INSPECTOR>
      '      <DEPRECATION>
      '        <MESSAGE>Potentially contains ... </MESSAGE>
      '        <ITEM>AnswerWizard.ResetFileList</ITEM>
      '        <URL>https://go.microsoft.com/fwlink/?linkid=171730&clcid=0x416
      
    4. Selecione Relatório Detalhado para criar um relatório no final do processo de inspeção. O relatório é um arquivo de texto semelhante ao exemplo a seguir.

      SUMMARY:
      ========
      
      Document scanned:        c:\TestFile.xls
      Date Scanned:            Thursday, November 12, 2009
      Total lines scanned:     101
      Total items found:       1
      Deprecated items:        0
      Changed items:           1
      Redesigned items:        0
      Declare statements:      0
      
      DETAILS:
      ========
      
      MODULE:            Module1
      FUNCTION:          Macro1
      LINE:              19
      TYPE:              CHANGE
      ITEM:              Workbook.VBProject
      URL:               https://go.microsoft.com/fwlink/?linkid=170116&clcid=0x416:              For Each comp In
      ActiveWorkbook.VBProject.VBComponents
      
  4. Depois que o Inspetor concluir seu exame, ele exibirá um relatório de resumo semelhante ao seguinte.

    Figura 2a. Resumo do Code Compatibility Inspector

    Resumo do Code Compatibility Inspector

    • Total de linhas verificadas – Número total de linhas de código VBA verificadas no documento.

    • Total de itens encontrados – Número total de itens problemáticos que o Inspetor encontrou no código, incluindo declarações Declare a serem atualizadas, itens alterados, itens preteridos e itens afetados pelas alterações no design.

    • Itens preteridos – Itens no código que foram removidos do modelo de objeto ou que não têm mais suporte nele. Se seu código depender de um item preterido, reconfigure a parte do código necessária.

    • Itens alterados – itens do código que usam um comando cuja sintaxe foi alterada. Se o seu código usar uma sintaxe desatualizada, será preciso atualizá-lo.

    • Itens reprojetados – itens do código cuja sintaxe é igual e ainda existe, mas cujo design atualizado pode gerar resultados inesperados no seu código. Por exemplo, a formatação de uma determinada caixa de texto pode ter mudado por causa de novos serviços de texto e, como resultado, seu código poderia criar uma caixa de texto, mas o layout do texto na caixa poderia ser diferente das versões anteriores.

    • Instruções Declare – número total de instruções de API do Windows detectadas no código VBA e então atualizadas para compatibilidade com 64 bits por meio da inclusão da palavra-chave PTRSAFE.

Inspecionando o código Visual Studio

Para inspecionar a compatibilidade de um documento, siga estas etapas:

  1. Abra a solução que deseja inspecionar no Visual Studio Tools for Office.

  2. No menu Ferramentas, clique em Inspecionar Código VSTO.

    Figura 3. Menu Ferramentas do VSTO

    Menu Ferramentas do VSTO

  3. Na caixa de diálogo Inspecionar Projeto VSTO, marque ou desmarque as opções, conforme apropriado, e clique em Inspecionar.

    Figura 4. Caixa de diálogo Inspecionar Projeto VSTO

    Caixa de diálogo Inspect VSTO Project (Inspecionar Projeto do VSTO)

    1. Selecione Inspecionar Origem do Visual Studio Tools for Office (VB.NET e C#) para inspecionar itens do projeto do Visual Studio Tools for Office no modelo de objeto que foram alterados ou removidos.

    2. Selecione Adicionar comentários para colocar comentários em seu código onde a ferramenta identificar potenciais problemas de compatibilidade. Os comentários adicionados pelo Inspetor são semelhantes ao exemplo a seguir.

      //<VSTO_INSPECTOR>
      //  <DEPRECATION>
      //      <MESSAGE>Potentially contains removed items...</MESSAGE>
      //      <ITEM>[mso]AnswerWizard.ResetFileList</ITEM>
      //      <URL>https://go.microsoft.com/fwlink/?linkid=171730&clcid=0x416
      
    3. Selecione Relatório Detalhado para criar um relatório no final do processo de inspeção. O relatório é um arquivo de texto semelhante ao exemplo a seguir.

      SUMMARY:
      ========
      
      Solution scanned:        ExcelAddIn1
      Date scanned:            Thursday, November 12, 2009
      Total lines scanned:     43
      Total items found:       3
      Deprecated items:        3
      Changed items:           0
      Redesigned items:        0
      
      DETAILS:
      ========
      
      MODULE:      ThisAddIn.cs
      FUNCTION:    ThisAddIn_Startup
      LINE:        17
      TYPE:        DEPRECATION
      APP:         mso
      ITEM:        AnswerWizard
      URL:         https://go.microsoft.com/fwlink/?linkid=171730&clcid=0x416:        xlApp.AnswerWizard.ResetFileList();
      
      MODULE:      ThisAddIn.cs
      FUNCTION:    ThisAddIn_Startup
      LINE:        19
      TYPE:        DEPRECATION
      APP:         xls
      ITEM:        SmartTagRecognizers
      URL:         https://go.microsoft.com/fwlink/?linkid=170614&clcid=0x416:        xlApp.SmartTagRecognizers.Recognize = true;
      
      MODULE:      ThisAddIn.cs
      FUNCTION:    ThisAddIn_Startup
      LINE:        22
      TYPE:        DEPRECATION
      APP:         xls
      ITEM:        SmartTags
      URL:         https://go.microsoft.com/fwlink/?linkid=170617&clcid=0x416:        MessageBox.Show(r.SmartTags.Count.ToString());
      
    4. Selecione Backup para fazer backup dos arquivos do projeto antes de inspecionar o código.

  4. Depois que o Inspetor concluir seu exame, ele exibirá um relatório de resumo semelhante ao seguinte.

    Figura 5. Resumo do Code Compatibility Inspector

    Resumo do Code Compatibility Inspector

    • Total de linhas verificadas – Número total de linhas de código Visual Basic .NET ou C# verificadas no documento.

    • Total de itens encontrados – Número total de itens problemáticos que o Inspetor encontrou no código, incluindo itens alterados, itens preteridos e itens afetados pelas alterações no design.

    • Itens preteridos – Itens no código que foram removidos do modelo de objeto ou que não têm mais suporte nele. Se seu código depender de um item preterido, reconfigure a parte do código necessária.

    • Itens alterados – itens do código que usam um comando cuja sintaxe foi alterada. Se o seu código usar uma sintaxe desatualizada, será preciso atualizá-lo.

    • Itens reprojetados – itens do código cuja sintaxe é igual e ainda existe, mas cujo design atualizado pode gerar resultados inesperados no seu código. Por exemplo, a formatação de uma determinada caixa de texto pode ter mudado por causa de novos serviços de texto e, como resultado, seu código poderia criar uma caixa de texto, mas o layout do texto na caixa poderia ser diferente das versões anteriores.

    • Instruções Declare – número total de instruções de API do Windows detectadas no código VBA e então atualizadas para compatibilidade com 64 bits por meio da inclusão da palavra-chave PTRSAFE.

Usando o inspetor

Se o Inspetor encontrar itens Alterados, Preteridos ou Reprojetados no código, depure o código e resolva todos os problemas. É aconselhável realizar um teste completo no código, inspecionando cada função. Enquanto você depura o código, verifique se há comentários do Office Code Compatibility Inspector acima das linhas que dividem o código. Esses comentários o ajudam a determinar o problema fundamental de determinada linha do código. Se o problema não for óbvio para você, cole a URL que aparece nos comentários em seu navegador para obter mais informações.

Removendo comentários no VBA

Para remover os comentários do código após concluir o processo e verificar a compatibilidade do seu código com o Office 2010, clique em Remover Comentários na guia Desenvolvedor no aplicativo do Office 2010.

O Inspetor remove todos os comentários inseridos no projeto VBA e notifica você sobre o número de itens removidos.

Figura 6. Mensagem que especifica o número de itens removidos

Mensagem que especifica o número de itens removidos

Removendo comentários no Visual Studio

Para remover os comentários do código após concluir o processo e verificar a compatibilidade do seu código com o Office 2010, clique em Remover Comentários do Inspetor VSTO no menu Ferramentas do Visual Studio.

O Inspetor remove todos os comentários inseridos no projeto Visual Studio Tools for Office e notifica você sobre o número de itens removidos.

Figura 6a. Mensagem que especifica o número de itens removidos

Mensagem que especifica o número de itens removidos