Partilhar via


Arquitetura de marcas inteligentes

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.

Projetos de nível de documento

  • O Excel 2003

  • O Excel 2007

  • Word 2003

  • Word 2007

Projetos de nível de aplicativo

  • O Excel 2007

  • Word 2007

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

Ferramentas do Visual Studio para o Office fornece um modelo de objeto de marca inteligente flexível que permite que você adicionar rapidamente as marcas inteligentes a documentos do Microsoft Office Word e pastas de trabalho do Microsoft Office Excel.Para obter situações Avançados, você também pode criar seus próprios identificadores de marcas inteligentes e dados de Acessar que estão armazenados na marca inteligente.

Para obter mais informações sobre marcas inteligentes Ferramentas do Visual Studio para o Office , consulte Visão geral sobre marcas inteligentes.

Visão geral do modelo de objeto

O modelo de objeto de marcas inteligentes Ferramentas do Visual Studio para o Office fornece classes separados para as marcas inteligentes e as ações que executam as marcas inteligentes.Para obter exemplos de código que demonstram como adicionar marcas inteligentes Ferramentas do Visual Studio para o Office a um documento, consulte Como: Adicionar marcas inteligentes a documentos do Word e Como: Adicionar marcas inteligentes a pastas de trabalho do Excel.

Marcas inteligentes

Uma marca inteligente Ferramentas do Visual Studio para o Office é uma instância de qualquer classe que deriva da classe abstrata SmartTagBase.Ferramentas do Visual Studio para o Office inclui duas classes que implementam a classe abstrata SmartTagBase: Microsoft.Office.Tools.Word.SmartTag and Microsoft.Office.Tools.Excel.SmartTag.A menos que você precise criar seu próprio identificador de marca inteligente, você pode usar essas instâncias de classes quando você Adicionar inteligentes marcas a um documento.

A classe SmartTagBase fornece os seguintes recursos:

  • O Terms e propriedades de Expressions, que contêm os termos reconhecíveis para a marca inteligente.Para especificar uma cadeia de caracteres simples, Adicionar a seqüência na propriedade Terms.Para especificar uma Cadeia de Caracteres complexa, Adicionar uma expressão regular que descreve a Cadeia de Caracteres na propriedade Expressions.

  • A propriedade Actions, que contém as ações a serem executadas quando o usuário seleciona a marca inteligente.

  • Um reconhecedor de marca inteligente padrão que compara a entrada do usuário com o conteúdo das propriedades de Terms e Expressions.

Ações

Quando o usuário seleciona a marca inteligente, o usuário pode executar uma ou mais ações que são específicas para a marca inteligente.Cada ação é representada por uma instância da classe Microsoft.Office.Tools.Word.Action ou Microsoft.Office.Tools.Excel.Action.Essas classes fornecem os eventos de BeforeCaptionShow e Click:

  • O evento BeforeCaptionShow é gerado apenas depois que o usuário clica no ícone de marca inteligente, mas antes da marca inteligente menu é exibido.Tratar este evento se desejar modificar o título da ação no menu de marca inteligente em tempo de execução.

  • O evento Click é disparado quando o usuário clica no título da ação no menu de marca inteligente.Tratar este evento para executar código quando o usuário clica a ação.

Os manipuladores de eventos para esses eventos recebem um Microsoft.Office.Tools.Excel.ActionEventArgs (para o Excel) ou Microsoft.Office.Tools.Word.ActionEventArgs (para o Word) que fornece Acessar para o texto reconhecido e a localização do texto.

Comportamento de reconhecimento de texto padrão

Quando um usuário digita texto em um documento ou pasta de trabalho, o Word e Excel Criar uma lista de tokens do texto.O reconhecedor de marca inteligente padrão na classe SmartTagBase recebe essa lista de símbolos e o textConcluir digitado pelo usuário.O reconhecedor padrão identifica uma marca inteligente se uma das condições a seguir for atendida:

  • Uma das seqüências na propriedade Terms coincide exatamente com um dos tokens no documento ou pasta de trabalho.

  • Uma das expressões regulares na propriedade Expressions terá correspondência no textConcluir digitado pelo usuário.

Word e Excel seqüências de análise que contêm incorporada espaços ou seqüências de caracteres que combinem letras, números e símbolos, para separar tokens quando um usuário digita-los.Por exemplo, se o usuário digita Relatar vendas, Word e Excel criará os símbolos "vendas" e "Relatar".Da mesma forma, se o usuário digitar "2005sales", Word e Excel criar os tokens "2005 " e " vendas".

Se quiser fazer a marca inteligente reconhece uma Cadeia de Caracteres que contém espaços ou uma Cadeia de Caracteres que combine letras, números e símbolos, não faça Adicionar a Cadeia de Caracteres na propriedade Terms.Em vez disso, adicionar uma expressão regular que descreve a Cadeia de Caracteres na propriedade Expressions, ou Criar seu próprio identificador que procura a Cadeia de Caracteres.

Criar identificadores de marca inteligente

Para criar seu próprio identificador de marca inteligente, derive uma Novo classe de SmartTagBase, Microsoft.Office.Tools.Word.SmartTagou Microsoft.Office.Tools.Excel.SmartTage substituir o método Recognize.

Em sua implementação de Recognize, você deve pesquisar o texto para termos de marca inteligente e registrar manualmente a marca inteligente com o Word ou Excel, se um termo de marca inteligente for encontrado.Para obter exemplos de como criar identificadores para Ferramentas do Visual Studio para o Office marcas inteligentes, consulte Como: Criar marcas inteligentes com identificadores de Personalizar no Word e Como: Criar marcas inteligentes com identificadores Personalizars no Excel.

O processo para registrar manualmente uma marca inteligente depende a classe de marca inteligente que você estiver derivando de.A tabela a seguir lista as opções diferentes para registrar uma marca inteligente.

Classe que você estiver derivando de

Como registrar a marca inteligente

Microsoft.Office.Tools.Word.SmartTag

Chame o método SmartTag.PersistTag.

Microsoft.Office.Tools.Excel.SmartTag

Chame o método SmartTag.PersistTag.

SmartTagBase

Chame o método CommitSmartTag do parâmetro do método siteRecognize.

O parâmetro site é um objeto que implementa a interface de ISmartTagRecognizerSite.Essa interface está disponível quando você Adicionar uma referência à Microsoft Inteligente tags 2.0 biblioteca de tipos ao seu projeto.Para obter mais informações, consulte a documentação de do SDK de marca inteligente na biblioteca MSDN.

Armazenar e recuperar dados em que o conjunto de propriedades

As marcas inteligentes podem armazenar dados em uma coleção de pares de chave e valor, conhecido como o recipiente de propriedades.Cada valor e chave no recipiente de propriedades é uma Cadeia de Caracteres.

Marcas inteligentes Ferramentas do Visual Studio para o Office fornecem duas maneiras de acessar o recipiente de propriedades:

Para obter exemplos de como gravar e ler o recipiente de propriedades, consulte Como: Criar marcas inteligentes com identificadores de Personalizar no Word e Como: Criar marcas inteligentes com identificadores Personalizars no Excel.

Expressões regulares e o conjunto de propriedades

Quando você Atribuir uma expressão regular para uma marca inteligente Ferramentas do Visual Studio para o Office, o reconhecedor padrão adiciona um par de chave e valor para cada AAgruparar capturado da expressão regular ao recipiente de propriedades da marca inteligente.

Para obter um exemplo que demonstra esse comportamento, consulte Demonstra Passo a passo: Criando uma marca inteligente com uma personalização em nível de documento.Para obter mais informações sobre grupos capturados em expressões regulares, consulte Agrupando Construtores e Classes de Expressões Regulares.

Consulte também

Tarefas

Como: Habilitar marcas inteligentes no Word e Excel

Como: Adicionar marcas inteligentes a documentos do Word

Como: Adicionar marcas inteligentes a pastas de trabalho do Excel

Como: Criar marcas inteligentes com identificadores de Personalizar no Word

Como: Criar marcas inteligentes com identificadores Personalizars no Excel

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

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

Conceitos

Visão geral sobre marcas inteligentes