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

Artigo
08/25/2010

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.

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.

Quando você estender um aplicativo do Microsoft Office, criando um Ferramentas do Visual Studio para o Office Adicionar - in, você Gravar código diretamente com a classe ThisAddIn no seu projeto. Você pode usar essa classe para executar tarefas como acessar o modelo de objeto do aplicativo host do Microsoft Office, personalizar a interface de usuário (UI) do aplicativo e expor objetos em seu Adicionar - na Outro soluções do Office.

Para Geral informações sobre suplementos de nível de aplicativo e outros tipos de soluções que você pode criar usando Ferramentas do Visual Studio para o Office, consulte Visão geral de desenvolvimento de soluções do Office.

Escrevendo código no projeto Adicionar-in

Você pode iniciar escrita seu Adicionar no código na classe ThisAddIn.Ferramentas do Visual Studio para o Office automaticamente gera essa classe na ThisAddIn.vb (em Visual Basic) ou o arquivo de código ThisAddIn.cs (em C#) em seu projeto de suplemento.

Há dois manipuladores de eventos padrão na classe ThisAddIn.Para executar código quando o Adicionar - in é carregado, Adicionar código ao manipulador de eventos ThisAddIn_Startup.Para executar código pouco antes o Adicionar - in é descarregado, Adicionar código ao manipulador de eventos ThisAddIn_Shutdown.For more information, see O Visual Studio Tools for Office Projeto eventos.

A classe ThisAddIn deriva a maioria dos seus recursos da classe AddIn.AddIn fornece funcionalidade de núcleo compartilhada por Tudo Ferramentas do Visual Studio para o Office Adicionar-ins. Para obter mais informações sobre a classe de AddIn , consulte Item de host addIn.

Acessando o modelo de objeto do aplicativo host

Para acessar o modelo de objeto do aplicativo host, use o campo Application da classe ThisAddIn.Este campo retorna um objeto que representa a instância atual do aplicativo host.

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

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 classe de ThisAddIn , use o objeto Globals para acessar a classe ThisAddIn.Para obter mais informações sobre o objeto de Globals , consulte Global Acessar a objetos no Visual Studio Tools para projetos do Office.

Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()

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

A tabela a seguir lista o tipo do valor de retorno para o campo Application em cada Adicionar no projeto.

Aplicativo host	Tipo de valor de retorno
Microsoft Office Excel	Microsoft.Office.Interop.Excel.Application
Microsoft Office InfoPath	Microsoft.Office.Interop.InfoPath.Application
Microsoft Office Outlook	Microsoft.Office.Interop.Outlook.Application
Microsoft Office PowerPoint	Microsoft.Office.Interop.PowerPoint.Application
Microsoft Office Projeto	Microsoft.Office.Interop.MSProject.Application
Microsoft Office Visio	Microsoft.Office.Interop.Visio.Application
Microsoft Office Word	Microsoft.Office.Interop.Word.Application

Personalizando a interface do usuário de aplicativos do Microsoft Office

Você programaticamente pode personalizar os aplicativos da interface do usuário do Microsoft Office usando um nível de aplicativo Adicionar - in.Para aplicativos do Microsoft Office 2003, os recursos de interface do usuário que você pode personalizar Incluir menus e barras de ferramentas.Aplicativos no 2007 Microsoft Office Sistema possuem alguns recursos de interface do usuário diferentes que você pode personalizar.Esses recursos Incluir a Faixa de Opções, painéis de tarefas Personalizar e regiões de formulário do Outlook.For more information, see Personalização de IU do Office.

Ferramentas do Visual Studio para o Office fornece designers e classes que você pode usar para criar painéis de tarefas personalizados, as personalizações da Faixa de Opções e regiões de formulário do Outlook.Esses designers e classes ajudam a simplificar o processo de personalizar esses recursos.Para obter mais informações, consulte Visão geral de painéis de tarefas Personalizar, Designer de Faixa de Opções e Criar regiões de formulário do Outlook.

Se você desejar personalizar um desses recursos de uma forma que não é compatível com o Ferramentas do Visual Studio para o Office classes e os designers, você também pode personalizar esses recursos Implementando um de interface de extensibilidade do na sua Adicionar - in.For more information, see Personalizando recursos de interface do usuário usando interfaces de extensibilidade.

Iniciando no Visual Studio 2008 Serviço Pack 1 (SP1), 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 que estendem o comportamento de documentos e pastas de trabalho.Isso permite que você adicionar controles gerenciados e marcas inteligentes Ferramentas do Visual Studio para o Office a documentos e planilhas.For more information, see Estendendo os documentos do Word e Excel pastas de trabalho no nível de aplicativo Adicionar-ins em tempo de execução.

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

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

For more information, see Chamar o código no nível de aplicativo Adicionar-ins de Outro soluções do Office.