Demonstra Passo a passo: Criando uma marca inteligente com um nível de aplicativo Adicionar - no

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 Word 2007 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

Word 2007

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

Esta explicação passo a passo demonstra como criar uma marca inteligente de nível de aplicativo que você pode usar em cada Abrir documento.A marca inteligente reconhece as medidas de tablespoon em um documento do Microsoft Office Word 2007 e fornece uma ação que converte o valor em onças.Ele adiciona o valor equivalente onça entre parênteses após o período de tablespoon.

Para executar a marca inteligente, os usuários finais deve ativar as marcas inteligentes no Word.For more information, see Como: Habilitar marcas inteligentes no Word e Excel.

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

Criar uma marca inteligente que usa uma expressão regular para reconhecer as seqüências de caracteres.
Criar uma ação que recupera dados de marca inteligente e modifica o texto reconhecido de marca inteligente.

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 novo projeto

A Primeiro etapa é criar uma palavra Adicionar no projeto.

Para criar um novo projeto

Criar uma palavra Adicionar - projeto com o nome Meu receitas Marca Inteligente, usando Visual Basic ou C#.

For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

O Visual Studio adiciona o projeto Minhas marcas inteligentes de receitas para Gerenciador de Soluções.

Configurando o projeto

O projeto precisa de uma referência para a marca inteligente DLL e também precisa usar expressões regulares.

Para configurar seu projeto

No menu Project, escolha Add Reference.
Na guia COM, Selecionar De biblioteca de tipo do Microsoft Inteligente tags 2.0 e clique em OK de .
Em Gerenciador de Soluções, clique com o botão direito do mouse ThisDocument.vb (no Visual Basic) ou ThisDocument.cs (em C#) e clique em Exibir Code.

Adicionar a seguinte linha de código para o início do arquivo.

Imports System.Text.RegularExpressions

using System.Text.RegularExpressions;

Criando a marca inteligente

Para habilitar a marca inteligente localizar e converter as medidas de tablespoon, adicionar uma expressão regular à lista de termos que a marca inteligente reconhece e criar uma ação que estará disponível quando o usuário clicar na marca inteligente.

Para criar a marca inteligente

Substituir o manipulador de eventos ThisAddIn_Startup na classe ThisAddIn com o código a seguir.Esse código cria um SmartTag que representa a marca inteligente Ferramentas do Visual Studio para o Office e adiciona uma expressão regular à lista de termos que reconhece a marca inteligente.

WithEvents RecipeAction As Microsoft.Office.Tools.Word.Action

Private Sub ThisAddIn_Startup(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Startup

    Dim SmartTagDemo As New Microsoft.Office.Tools.Word.SmartTag( _
        "www.microsoft.com/Demo#DemoSmartTag", "Recipe Smart Tag")

    SmartTagDemo.Expressions.Add(New Regex( _
        "(?'tbsNumber'[+-]?\b[0-9]+)?\s?(tbs|tablespoons|tablespoon)\b"))

private Microsoft.Office.Tools.Word.Action RecipeAction;

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Word.SmartTag SmartTagDemo =
        new Microsoft.Office.Tools.Word.SmartTag(
        @"www.microsoft.com/Demo#DemoSmartTag",
        @"Recipe Smart Tag");

    // Specify the terms to recognize.
    SmartTagDemo.Expressions.Add(new Regex(
        @"(?'tbsNumber'[+-]?\b[0-9]+)?\s?(tbs|tablespoons|tablespoon)\b"));

Criar um novo Action e Adicionar-lo para a propriedade Actions da marca inteligente.O Action representa um item que o usuário pode Clique no menu de marca inteligente.

RecipeAction = New Microsoft.Office.Tools.Word.Action("Convert to ounces")

SmartTagDemo.Actions = _
    New Microsoft.Office.Tools.Word.Action() {RecipeAction}

RecipeAction = new Microsoft.Office.Tools.Word.Action(
    @"Convert to ounces");

// Add the action to the smart tag.
SmartTagDemo.Actions = new
    Microsoft.Office.Tools.Word.Action[] { RecipeAction };

Anexe a marca inteligente à propriedade VstoSmartTags da classe ThisAddIn.No C#, anexe um manipulador de eventos ao evento Click da ação.

    Me.VstoSmartTags.Add(SmartTagDemo)
End Sub

    // Add the smart tag to the document.
    this.VstoSmartTags.Add(SmartTagDemo);

    RecipeAction.Click += new
        Microsoft.Office.Tools.Word.ActionClickEventHandler(
        RecipeAction_Click);
}

Criar um manipulador de eventos para a ação

O manipulador de eventos recupera o valor de tablespoon a chave tbsNumber, que está no recipiente de propriedades da marca inteligente.O manipulador de eventos, em seguida, converte o valor de tablespoon em onças e insere o valor de onça entre parênteses após o valor de tablespoon.

Neste exemplo, a chave tbsNumber identifica um AAgruparar capturado da expressão regular atribuída a marca inteligente.Para obter mais informações sobre pacotes de propriedade e expressões regulares em marcas inteligentes Ferramentas do Visual Studio para o Office , consulte Arquitetura de marcas inteligentes.

Para criar o manipulador de eventos

Copiar o código a seguir à classe ThisAddIn.

Private Sub RecipeAction_Click(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ActionEventArgs) _
    Handles RecipeAction.Click

    Dim value As String = e.Properties.Read("tbsNumber")
    Dim tbsRecipeAmount As Double = System.Convert.ToDouble(value)
    Dim ozRecipeAmount As Double = tbsRecipeAmount * 0.5
    e.Range.InsertAfter(" (" + ozRecipeAmount.ToString() + " oz)")
End Sub

private void RecipeAction_Click(object sender,
    Microsoft.Office.Tools.Word.ActionEventArgs e)
{
    string value = e.Properties.get_Read(@"tbsNumber");
    double tbsRecipeAmount = System.Convert.ToDouble(value);
    double ozRecipeAmount = tbsRecipeAmount * 0.5;
    e.Range.InsertAfter(" (" + ozRecipeAmount.ToString() + " oz)");
}

Testando o aplicativo

Agora você pode testar seu documento para verificar que a marca inteligente converte tablespoon medidas em onças.

Para testar a sua pasta de trabalho

No Word, habilite as marcas inteligentes.

For more information, see Como: Habilitar marcas inteligentes no Word e Excel.
Pressionarionar F5 para executar seu projeto.
tipo uma receita com a quantidade de ingrediente medido em Sopa.
Clique no ícone de marca inteligente que aparece sobre a Cadeia de Caracteres reconhecida e clique em converter para onças.
Confirme que o equivalente de onça é inserido após o valor de tablespoon.