Partilhar via


Os suplementos de nível de aplicativo de programação.

Quando você estende um aplicativo de Microsoft Office criando um suplemento em nível de aplicativo, você escreve o código diretamente contra o ThisAddIn classe no projeto. Você pode usar essa classe para executar tarefas como, por exemplo, acessando o modelo de objeto do aplicativo host de Microsoft Office, personalizando a interface do usuário (UI) do aplicativo e expor objetos no seu suplemento a outras soluções do Office.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Microsoft Office 2010 e o sistema 2007 do Microsoft Office. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Alguns aspectos de escrever código em projetos de suplemento são diferentes dos outros tipos de projetos em Visual Studio. Muitas dessas diferenças são causadas pela maneira como o Office em modelos de objeto são expostos ao código gerenciado. For more information, see Escrevendo código em soluções do Office.

Para obter informações gerais sobre os suplementos de nível de aplicativo e outros tipos de soluções que você pode criar usando as ferramentas de desenvolvimento do Office em Visual Studio, consulte Visão geral de desenvolvimento de soluções do Office.

Usando a classe ThisAddIn

Você pode começar a escrever seu código de suplemento ThisAddIn classe. Visual Studio gera automaticamente essa classe no ThisAddIn. vb (em Visual Basic) ou ThisAddIn.cs (em C#) o arquivo de código no seu suplemento project. O Visual Studio Tools for Office runtime automaticamente cria uma instância dessa classe para você quando o aplicativo de Microsoft Office carrega o add-in.

Existem dois manipuladores de eventos padrão na ThisAddIn classe. Para executar código quando o suplemento é carregado, adicione código para o ThisAddIn_Startup manipulador de eventos. Para executar código antes do suplemento é descarregado, adicione código para o ThisAddIn_Shutdown manipulador de eventos. Para obter mais informações sobre esses manipuladores de eventos, consulte Eventos em projetos do Office.

ObservaçãoObservação

Em 2010 do Outlook, por padrão o ThisAddIn_Shutdown manipulador de eventos não é sempre chamado quando o suplemento é descarregado. For more information, see Eventos em projetos do Office.

Acessando o modelo de objeto do aplicativo Host

Para acessar o modelo de objeto do aplicativo host, use o Application campo de ThisAddIn classe. Esse campo retorna um objeto que representa a instância atual do aplicativo host. A tabela a seguir lista o tipo de valor de retorno para o Application campo em cada suplemento do projeto.

Aplicativo de host

Tipo de valor de retorno

Excel de Microsoft Office

Microsoft.Office.Interop.Excel.Application

InfoPath Microsoft Office

Microsoft.Office.Interop.InfoPath.Application

Microsoft Office Outlook

Microsoft.Office.Interop.Outlook.Application

PowerPoint de Microsoft Office

Microsoft.Office.Interop.PowerPoint.Application

Projeto de Microsoft Office

Microsoft.Office.Interop.MSProject.Application

Visio Microsoft Office

Microsoft.Office.Interop.Visio.Application

Palavra de Microsoft Office

Microsoft.Office.Interop.Word.Application

O exemplo de código a seguir mostra como usar o Application campo para criar uma nova pasta de trabalho em um suplemento para Microsoft Office Excel. Este exemplo se destina a ser executado a partir de ThisAddIn classe.

Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()
Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);

Para fazer a mesma coisa de fora a ThisAddIn da classe, use o Globals o objeto para o acesso a ThisAddIn classe. Para obter mais informações sobre o Globals de objeto, consulte Acesso global a objetos em projetos do Office.

Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()
Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);

Para obter mais informações sobre os modelos de objeto de aplicativos específicos de Microsoft Office, consulte os seguintes tópicos:

Membros da ThisAddIn uso para outras tarefas.

A tabela a seguir descreve outras tarefas comuns e mostra quais membros na ThisAddIn classe, você pode usar para executar tarefas.

Task

Membro usar

Execute o código para inicializar o suplemento quando o suplemento é carregado.

Adicione código para o ThisAddIn_Startup método. Este é o manipulador de eventos padrão para o Startup de evento. For more information, see Eventos em projetos do Office.

Execute o código para limpar recursos, usados pelo suplemento antes do suplemento é descarregado.

Adicione código para o ThisAddIn_Shutdown método. Este é o manipulador de eventos padrão para o Shutdown de evento. For more information, see Eventos em projetos do Office.

ObservaçãoObservação
Em 2010 do Outlook, por padrão o ThisAddIn_Startup manipulador de eventos não é sempre chamado quando o suplemento é descarregado.Para obter mais informações, consulte consulte Eventos em projetos do Office.

Exiba um painel de tarefas personalizado.

Use o CustomTaskPanes campo. For more information, see Visão geral sobre painéis de tarefas personalizado.

Crie uma marca inteligente que pode ser reconhecida em qualquer documento aberto do Word ou uma pasta de trabalho do Excel.

ObservaçãoObservação
As marcas inteligentes estão obsoletas no Excel 2010 e Word 2010.For more information, see Visão geral sobre marcas inteligentes.

Use o VstoSmartTags campo em um suplemento para o Excel ou Word. For more information, see Visão geral sobre marcas inteligentes.

Expor objetos no seu suplemento a outras soluções de Microsoft Office.

Override the RequestComAddInAutomationService method. For more information, see Código de chamada no nível do aplicativo Add-ins de outras soluções do Office.

Personalize um recurso do sistema de Microsoft Office com a implementação de uma interface de extensibilidade.

Substituir o RequestService método para retornar uma instância de uma classe que implementa a interface. For more information, see Personalizando os recursos de interface do usuário usando Interfaces de extensibilidade.

ObservaçãoObservação
Para personalizar a interface do usuário, você também pode substituir o CreateRibbonExtensibilityObject método.

Noções básicas sobre o Design da classe ThisAddIn

Em projetos destinados a.NET Framework 3.5, o ThisAddIn classe deriva do Microsoft.Office.Tools.AddIn classe na Visual Studio Tools for Office runtime.

Em projetos destinados a .NET Framework 4, Microsoft.Office.Tools.AddIn é uma interface, portanto, o gerado ThisAddIn classe não pode derivar de qualquer implementação do proprietário. Em vez disso, o ThisAddIn classe deriva do Microsoft.Office.Tools.AddInBase classe. Essa classe base redireciona todas as chamadas para seus membros a implementação interna da Microsoft.Office.Tools.AddIn interface o Visual Studio Tools for Office runtime. Para obter mais informações sobre as diferenças na Visual Studio Tools for Office runtime para projetos destinados a.NET Framework 3.5 e o .NET Framework 4, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.

Em projetos de suplemento do Outlook, o ThisAddIn classe deriva da a classeMicrosoft.Office.Tools.Outlook.OutlookAddIn em projetos destinados a.NET Framework 3.5 e a partir de Microsoft.Office.Tools.Outlook.OutlookAddInBase em projetos destinados a .NET Framework 4. Essas classes base fornecem algumas funcionalidades adicionais para oferecer suporte a regiões de formulário. Para obter mais informações sobre regiões de formulário, consulte Criação de regiões de formulário do Outlook.

Personalizando a Interface de usuário de aplicativos de Microsoft Office

Programaticamente, você pode personalizar os aplicativos de interface do usuário do Microsoft Office usando um suplemento em nível de aplicativo. Por exemplo, pode personalizar a faixa de opções, exibir um painel de tarefas personalizado ou criar uma região de formulário personalizado no Outlook. For more information, see Personalização de interface do usuário do Office.

Visual Studio fornece classes que você pode usar para criar painéis de tarefas personalizados, personalizações de faixa de opções e regiões de formulário do Outlook e designers. Essas classes e os designers ajudam a simplificar o processo de personalizar esses recursos. For more information, see Visão geral sobre painéis de tarefas personalizado, Designer de faixa de opções, and Criação de regiões de formulário do Outlook.

Se você desejar personalizar um desses recursos, de forma que não há suporte para as classes e os designers, você também pode personalizar esses recursos com a implementação de um interface de extensibilidade no seu suplemento. For more information, see Personalizando os recursos de interface do usuário usando Interfaces de extensibilidade.

Você também pode modificar os documentos de interface do usuário do Word e pastas de trabalho do Excel por gerar itens de host estendem o comportamento de documentos e pastas de trabalho. Isso permite que você adicione controles gerenciados e marcas inteligentes para documentos e planilhas. For more information, see Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

Código de chamada no nível do aplicativo Add-ins de outras soluções

Você pode expor os objetos no seu suplemento para outras soluções, incluindo outras soluções do Office. Isso é útil se o seu suplemento fornece um serviço que você deseja ativar a outras soluções de usar. Por exemplo, se você tiver um suplemento do Excel de Microsoft Office que executa cálculos nos dados financeiros de um serviço Web, outras soluções podem executar esses cálculos chamando o suplemento do Excel em tempo de execução.

For more information, see Código de chamada no nível do aplicativo Add-ins de outras soluções do Office.

Consulte também

Tarefas

Demonstra Passo a passo: Chamar o código do VBA em um suplemento em nível de aplicativo

Como: Criar projetos do Office em Visual Studio

Conceitos

Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução

Código de chamada no nível do aplicativo Add-ins de outras soluções do Office

Personalizando os recursos de interface do usuário usando Interfaces de extensibilidade

Arquitetura dos suplementos de nível de aplicativo

Escrevendo código em soluções do Office

Outros recursos

Desenvolvimento de soluções do Office