Arquitetura de marcas inteligentes

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. 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.

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.

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:

Você pode manipular o Click ou eventos BeforeCaptionShow a Microsoft.Office.Tools.Word.Action ou Microsoft.Office.Tools.Excel.Action classes e use a propriedade Properties do parâmetro de argumento de evento para gravar e ler do recipiente de propriedades da marca inteligente.A propriedade Properties retorna um objeto que implementa a interface de ISmartTagProperties.A interface de de ISmartTagProperties é disponível quando você Adicionar uma referência à Microsoft Smart tags 2.0 biblioteca de tipos ao seu projeto.
Você pode implementar o método Recognize em uma classe que deriva de SmartTagBase, Microsoft.Office.Tools.Word.SmartTagou Microsoft.Office.Tools.Excel.SmartTag.O parâmetro site desse método fornece um método de GetNewPropertyBag que retorna um objeto ISmartTagProperties, que você pode usar para gravar e ler do recipiente de propriedades da marca inteligente.

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.