Demonstra Passo a passo: Criando uma marca inteligente com uma personalização em nível de documento

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 documento Versão do Microsoft Office Word 2003 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 documento

Versão do Microsoft Office

Word 2003
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 em uma personalização de nível de documento do Word.A marca inteligente reconhece Fahrenheit seqüências de caracteres de temperatura.A marca inteligente inclui uma ação que converte o valor de temperatura para Celsius e substitui o texto reconhecido por um Celsius formatada cadeia de caracteres de temperatura.

Para executar esta 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 reconhece uma expressão regular.
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).
O Microsoft Office Word 2003 ou 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 um projeto de documento do Word.

Para criar um novo projeto

Criar um projeto de documento do Word com o nome Meu Marca Inteligente, usando Visual Basic ou C#.No assistente, Selecionar Criar um documento novo.

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

O Visual Studio abre o novo documento do Word no designer e adiciona o projeto Minhas marcas inteligentes 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.

 [Visual Basic]
Imports System.Text.RegularExpressions

using System.Text.RegularExpressions;

Criando a marca inteligente

Para habilitar a marca inteligente localizar e converter Fahrenheit seqüências de caracteres de temperatura, adicionar uma expressão regular para a lista de termos que reconhece a marca inteligente 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 ThisDocument_Startup na classe ThisDocument 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 action1 As Microsoft.Office.Tools.Word.Action

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

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

    smartTag1.Expressions.Add( _
        New Regex("(?'number'[+-]?\b[0-9]+)?\s?(F|f)\b"))

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

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

    smartTag1.Expressions.Add(new Regex(
        @"(?'number'[+-]?\b[0-9]+)?\s?(F|f)\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.

action1 = New Microsoft.Office.Tools.Word.Action( _
    "Convert to Celsius")

smartTag1.Actions = _
    New Microsoft.Office.Tools.Word.Action() {action1}

action1 = new Microsoft.Office.Tools.Word.Action(
    "Convert to Celsius");

smartTag1.Actions = new
    Microsoft.Office.Tools.Word.Action[] {action1};

Anexar a marca inteligente ao documento adicionando a propriedade SmartTag a VstoSmartTags.No C#, anexe um manipulador de eventos ao evento Click da ação.

    Me.VstoSmartTags.Add(smartTag1)
End Sub

    this.VstoSmartTags.Add(smartTag1);

    action1.Click += new
        Microsoft.Office.Tools.Word.ActionClickEventHandler(
        action1_Click);
}

Criar um manipulador de eventos para a ação

O manipulador de eventos recupera o Fahrenheit valor de temperatura da chave número, que está no recipiente de propriedades da marca inteligente.O manipulador de eventos então converte o Fahrenheit valor de temperatura para Celsius e substitui a Cadeia de Caracteres reconhecida.

Neste exemplo, o número de chave identifica um AAgruparar capturado da expressão regular atribuída à 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 ThisDocument.

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

    Dim value As String = e.Properties.Read("number")
    Dim fahrenheit As Double = System.Convert.ToDouble(value)
    Dim celsius As Integer = Fix(fahrenheit - 32) * 5 / 9
    e.Range.Text = celsius.ToString() + "C"
End Sub

void action1_Click(object sender,
    Microsoft.Office.Tools.Word.ActionEventArgs e)
{
    string value = e.Properties.get_Read("number");
    double fahrenheit = System.Convert.ToDouble(value);
    int celsius = (int)(fahrenheit - 32) * 5 / 9;
    e.Range.Text = celsius.ToString() + "C";
}

Testando o aplicativo

Agora você pode testar seu documento para garantir que a marca inteligente converte Fahrenheit temperaturas para Celsius.

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.
Digite uma Cadeia de Caracteres que está de acordo com a expressão regular você Adicionado à marca inteligente, como 60F, 60 ° Fou 60 F.

Observação:

Para tipo um símbolo de grau (°), Pressionarionar ALT e tipo 248.
Clique no ícone de marca inteligente que aparece sobre a Cadeia de Caracteres reconhecida e clique em converter em Celsius.
Confirmar que a Cadeia de Caracteres de caracteres original é substituída por um Novo Cadeia de Caracteres que contém a temperatura em Celsius.