Item de host addIn

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 aplicativo Versão do Microsoft Office Microsoft Office Sistema de 2007 Microsoft Office 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

A classe Microsoft.Office.Tools.AddIn é de item de host para o nível de aplicativo Adicionar-ins que você cria usando Ferramentas do Visual Studio para o Office.Um item de host é uma classe em uma solução de Ferramentas do Visual Studio para o Office que fornece o ponto de entrada para seu código.

Noções básicas sobre o AddIn e ThisAddIn classes

A classe AddIn fornece funcionalidade Núcleo que é compartilhada por Tudo Ferramentas do Visual Studio para o Office Adicionar-ins. No entanto, não explicitamente você deve criar uma instância dessa classe ou usá-lo diretamente em seu código.

Em vez disso, use a classe ThisAddIn.Ferramentas do Visual Studio para o Office gera essa classe em seu projeto de suplemento para servir como o link de comunicação entre o aplicativo Microsoft Office e seu código de suplemento. A classe ThisAddIn deriva AddIn. Ferramentas do Visual Studio para o Office cria automaticamente essa classe para você quando um aplicativo do Microsoft Office carrega o Adicionar-in.

A classe ThisAddIn fornece um local no qual você pode iniciar escrever código em seu projeto.Você também pode usar ThisAddIn para executar tarefas como acessar o modelo de objeto do aplicativo host.For more information, see Programação Application-Nível Adicionar-ins.

Usando AddIn e ThisAddIn em projetos de suplemento do Outlook 2007

Adicionar-em projetos para o Microsoft Office Outlook 2007, use um item de host diferentes, Microsoft.Office.Tools.Outlook.OutlookAddIn.Essa classe deriva de AddIn e adiciona funcionalidade adicional para oferecer suporte a regiões de formulário.Para obter mais informações sobre regiões de formulário, consulte Criar regiões de formulário do Outlook.

Em Adicionar-in de projetos para o Outlook 2007, a classe ThisAddIn deriva OutlookAddIn.Você usa a classe de ThisAddIn no Outlook 2007 Adicionar-ins exatamente como você usar essa classe em suplementos para outros aplicativos do Microsoft Office.

Membros para usar para várias tarefas

A tabela a seguir descreve tarefas ComComumComum e mostra quais membros da classe ThisAddIn você pode usar para executar as tarefas.

Tarefa	Membro para usar
Execute o código para inicializar o Adicionar-in quando o suplemento é carregado.	Adicionar código para o método ThisAddIn_Startup.Isso é o manipulador de eventos padrão para o evento Startup.For more information, see O Visual Studio Tools for Office Projeto eventos.
Execute o código para Apagar recursos utilizados pelo Adicionar-in antes que o suplemento seja descarregado.	Adicionar código para o método ThisAddIn_Shutdown.Isso é o manipulador de eventos padrão para o evento Shutdown.For more information, see O Visual Studio Tools for Office Projeto eventos.
Automatizar o aplicativo host, acessando o modelo de objeto.	Use o campo Application da classe ThisAddIn.Isso retorna uma instância da classe Application do aplicativo que seu Adicionar - funciona com.For more information, see Programação Application-Nível Adicionar-ins.
Criar uma marca inteligente que possa ser reconhecida em qualquer documento do Word aberto ou a pasta de trabalho do Excel.Esse recurso é novo no Visual Studio 2008 Serviço Pack 1 (SP1).	Use o campo VstoSmartTags da classe ThisAddIn.Este campo está disponível somente no Adicionar - in de projetos para o Excel 2007 e o Word 2007 que você criar depois de instalar o SP1.For more information, see Visão geral sobre marcas inteligentes.
Expor objetos seu Adicionar - na Outro soluções do Microsoft Office.	Substitua o método RequestComAddInAutomationService.For more information, see Chamar o código no nível de aplicativo Adicionar-ins de Outro soluções do Office.
Personalizar um recurso no 2007 Microsoft Office Sistema, implementar uma interface de extensibilidade.	Substituir o método RequestService para retornar uma instância de uma classe que implementa a interface.For more information, see Personalizando recursos de interface do usuário usando interfaces de extensibilidade. Observação: Para personalizar a interface do usuário da Faixa de Opções, você também pode substituir o Método CreateRibbonExtensibilityObject.

Consulte também

Tarefas

Demonstra Passo a passo: Chamar o código em um aplicativo-nível Adicionar - in do VBA

Conceitos

Programação Application-Nível Adicionar-ins

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

Personalizando recursos de interface do usuário usando interfaces de extensibilidade

Chamar o código no nível de aplicativo Adicionar-ins de Outro soluções do Office

Introdução Programação Application-Nível Adicionar-ins

O Visual Studio Tools for Office Projeto eventos

Date	History	Motivo
De 2008 de julho	Informações Adicionados sobre como adicionar marcas inteligentes a documentos usando suplementos em nível de aplicativo.	Alteração de recurso do SP1.