Compartilhar via


Demonstra Passo a passo: Chamar o código de VBA em um projeto do Visual Basic

Se aplica a

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

  • Projetos de nível de documento

Versão do Microsoft Office

  • Microsoft Office Sistema de 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Esta explicação passo a passo demonstra como chamar um método em uma personalização de nível de documento do Microsoft Office Word 2007 no Visual Basic para código Applications (VBA) no documento.O procedimento envolve três Basic etapas: Adicionar um método à classe de item de host de ThisDocument, expor o método para código do VBA e chamamos o método do código do VBA no documento.

Embora esta explicação passo a passo use o Word especificamente, os conceitos demonstrado pelo explicação passo a passo também Aplicar para projetos de nível de documento para o Microsoft Office Excel 2007.

Essa explicação passo a passo ilustra as seguintes tarefas:

  • Criar um documento que contenha código VBA.

  • Confiando o local do documento usando a relação de confiança Centralizar no Word.

  • Adicionando um método à classe de item de host de ThisDocument.

  • Expor o método para código do VBA.

  • Chamando o método de código do VBA.

Observação:

Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir.A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos.Para obter mais informações, consulte Configurações do Visual Studio.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

  • Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).

  • Microsoft Office Word 2007.

Ferramentas do Visual Studio para o Office é instalado por padrão com as versões listadas do Visual Studio.Para Marcar se ele está instalado, Marcar Instalando o Visual Studio Tools para Office.

Criando um documento que contém o código do VBA

A Primeiro etapa é criar um documento habilitado para macro que contém uma macro VBA simples.O documento deve conter um projeto do VBA antes de criar um projeto do Visual Studio que se baseia no documento.Caso contrário, Ferramentas do Visual Studio para o Office não é possível modificar o projeto do VBA para habilitar o código do VBA para chamar o assembly de Ferramentas do Visual Studio para o Office.

Se você já tiver um documento que contenha código VBA que você deseja usar, você pode ignorar esta etapa.

Para criar um documento que contenha código VBA

  1. Iniciar Word 2007.

  2. Salvar o documento ativo como um Word Macro-Habilitado documento (*.docm) com o nome DocumentWithVBA.Salvar-o em um local conveniente, como a área de trabalho.

  3. Na faixa de opções, clique na guia de De desenvolvedor.

    Observação:

    Se a Guia do desenvolvedor não estiver visível, você primeiro deve mostrá-lo.For more information, see Como: Mostrar a guia Desenvolvedor na Faixa de Opções.

  4. No AAgruparar de De código de , clique em do Visual Basic.

    O Editor do Visual Basic é aberto.

  5. Na janela Projeto , clique Duplo em ThisDocument.

    O arquivo de código para o objeto ThisDocument é aberto.

  6. Adicionar o seguinte código VBA para o arquivo de código.Esse código define uma função simples que não faz nada.A única finalidade desta função é verifique se existe um projeto do VBA no documento.Isso é necessário para etapas posteriores nesta explicação passo a passo.

    Sub EmptySub()
    End Sub
    
  7. Salvar o documento e Sair Word.

Criando o projeto

Agora você pode criar um projeto de nível de documento para Word 2007 que usa o documento habilitado para macro criado anteriormente.

Para criar um novo projeto

  1. Inicie o Visual Studio

  2. No menu File, aponte para New, e em seguida, clique em Project.Se o IDE está configurado para usar as configurações de desenvolvimento do Visual Basic, no menu arquivo, clique em Novo projeto.

  3. No painel de A Projeto Types, Expandirir do Visual Basic e em seguida, Expandirir Office.

  4. Selecionar a pasta de 2007.

  5. No painel modelos, Selecionar o projeto de documento do Word.

  6. Na caixa Nome, tipo CallingCodeFromVBA.

  7. Clique em OK.

    Abre o Visual Studio Tools para Office Projeto Assistente.

  8. Selecionar Copiar um documento existentee, no caminho completo Da caixa de de documento existente, especifique o local do documento de DocumentWithVBA que você criou anteriormente.Se você estiver usando seu próprio documento habilitado para macro, especifique o local deste documento em vez disso.

  9. Clique em Finish.

    Visual Studio abre o documento de DocumentWithVBA no designer e adiciona o projeto de CallingCodeFromVBA para Gerenciador de Soluções.

Confiar no local do documento

Antes de você pode expor código em sua solução ao código do VBA no documento, você deve confiar VBA do documento para executar.Há várias maneiras para fazer isso.Para esta explicação passo a passo, confiar no local do documento na Confiança Centralizar no Word.

Para confiar o local do documento

  1. Word Iniciar.

  2. Click the Microsoft Office Button.

  3. Clique no botão de opções do Word.

  4. No painel de categorias, clique em Confiar Central.

  5. No painel de detalhes, clique De Confiar Centralizar configurações.

  6. No painel de categorias, clique em Locais confiáveis.

  7. No painel de detalhes, clique Adicionar novo local.

  8. Na caixa de diálogo Local confiável do Microsoft Office, Procurar para a pasta que contém o projeto CallingCodeFromVBA.

  9. Selecionar Subpastas deste local também são confiáveis.

  10. Em Local confiável do Microsoft Office Caixa de Diálogo, clique em OK.

  11. Na caixa diálogo Confiar Central , clique em OK.

  12. Em Opções do Word Caixa de Diálogo, clique em OK.

  13. Word Sair.

Adicionando um método à classe ThisDocument

Agora que o projeto do VBA está configurado, Adicionar um método para a classe de item de host ThisDocument que você pode chamar do código do VBA.

Para adicionar um método à classe ThisDocument

  1. Em Gerenciador de Soluções, clique com o botão direito do mouse ThisDocument.vbe clique em Exibir Code.

    O arquivo de de ThisDocument.vb abre no editor de códigos.

  2. Adicionar o seguinte método à classe ThisDocument.Esse método cria uma tabela com duas linhas e duas colunas no início do documento.Os parâmetros especificam o texto que é exibido na Primeiro linha.Posteriormente nesta explicação passo a passo, você chamará esse código de VBA de método no documento.

    Public Sub CreateTable(ByVal firstColumnHeader As String, _
        ByVal secondColumnHeader As String)
    
        Me.Paragraphs(1).Range.InsertParagraphBefore()
        Dim table1 As Word.Table = Me.Tables.Add(Me.Paragraphs(1).Range, 2, 2)
    
        With table1
            .Style = "Table Professional"
            .Cell(1, 1).Range.Text = firstColumnHeader
            .Cell(1, 2).Range.Text = secondColumnHeader
        End With
    End Sub
    
  3. Crie o projeto.

Expor o método para código do VBA

Para expor o método CreateTable para código do VBA no documento, defina a propriedade de EnableVbaCallers para o item de hostThisDocument como Verdadeiro.

Para expor o método para código do VBA

  1. Em Gerenciador de Soluções, clique Duplo em ThisDocument.vb.

    O arquivo de DocumentWithVBA abre no designer.

  2. Na janela Propriedades , Selecionar EnableVbaCallers propriedade, e Alterar o valor de Verdadeiro .

  3. Clique em OK na mensagem que é exibida.

  4. Crie o projeto.

Chamar o código de VBA de método

Agora você pode chamar o método CreateTable do código do VBA no documento.

Observação:

Em Esta explicação passo a passo, você irá Adicionar Código do VBA para o documento durante a Depurando do projeto.O código do VBA que você adicionar a este documento será substituído na Avançar vez que você criar o projeto, porque o Visual Studio substituirá o documento na pasta de saída de compilação com uma Copiar do documento da pasta do projeto principal.Se você desejar salvar o código do VBA , você pode Copiar-las para o documento na pasta projeto .Para obter mais informações, consulte Chamar o código em nível de documento personalizações do VBA.

Para chamar o código de VBA de método

  1. Pressionarionar F5 para executar seu projeto.

  2. Na guia de Developer, no AAgruparar código, clique em do Visual Basic.

    O Editor do Visual Basic é aberto.

  3. No menu Inserir, clique em Módulo.

  4. Adicionar o seguinte código para o novo módulo.

    Este código chama o método CreateTable no assembly Ferramentas do Visual Studio para o Office.A macro acessa esse método usando a propriedade CallVSTOAssembly do objeto ThisDocument.Essa propriedade foi gerada automaticamente quando você definir EnableVbaCallers propriedade anteriormente nesta explicação passo a passo.

    Sub CreateTable()
        Call ThisDocument.CallVSTOAssembly.CreateTable("Employee Name", "Start Date")
    End Sub
    
  5. Pressione F5.

  6. Verificar se um Novo Tabela foi adicionado ao documento.

  7. Sair Word sem Salvando as alterações.

Próximas etapas

Você pode saber mais sobre como chamar código em Ferramentas do Visual Studio para o Office soluções do VBA nestes tópicos:

Consulte também

Tarefas

Como: Expor código VBA em um projeto do Visual Basic

Como: Expor código VBA em um projeto do Visual C#

Demonstra Passo a passo: Chamar o código de VBA em um projeto do Visual C#

Conceitos

Combinação de VBA e personalizações de nível de documento

Personalizações de nível de documento de programação