Método SmartTagRecognizeContext.PersistTag

Artigo
08/01/2011

Armazena informações sobre a marca inteligente.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Sub PersistTag ( _
    startIndex As Integer, _
    length As Integer, _
    propertyBag As ISmartTagProperties _
)

void PersistTag(
    int startIndex,
    int length,
    ISmartTagProperties propertyBag
)

Parâmetros

startIndex
Tipo: System.Int32
A posição do parágrafo onde começa a marca inteligente.

length
Tipo: System.Int32
O comprimento da marca inteligente.

propertyBag
Tipo: Microsoft.Office.Interop.SmartTag.ISmartTagProperties
Um conjunto de propriedades que contém pares de chave e valor para o token.Can be nulluma referência nula (Nothing no Visual Basic).

Exceções

Exceção	Condição
InvalidOperationException	PersistTagnão foi chamado a partir de Recognize método.

Comentários

Chame PersistTag a partir de uma implementação da Recognize método para indicar que a marca inteligente foi encontrada no texto. Use o propertyBag parâmetro para confirmar quaisquer propriedades personalizadas para smart tag. Você pode usar essas propriedades para personalizar a ação executada quando um item de menu de atalho de marca inteligente está selecionado.

Exemplos

O exemplo de código a seguir demonstra como chamar PersistTag a partir de uma implementação de Recognize método. Essa implementação compara cada termo de marca inteligente para o conteúdo do parágrafo. A cada termo de marca inteligente no parágrafo, o código adiciona uma propriedade de marca inteligente personalizada e, em seguida, usa o PersistTag método para reconhecer o smart tag. Este exemplo assume que você adicionou uma referência a Microsoft.Office.Interop.SmartTag partir do .NET guia de Add Reference caixa de diálogo. Este exemplo de código é parte de um exemplo maior fornecido para a ISmartTagExtension interface.

Private Sub Recognize(ByVal text As String,
    ByVal site As ISmartTagRecognizerSite,
    ByVal tokenList As ISmartTagTokenList,
    ByVal context As SmartTagRecognizeContext) Implements ISmartTagExtension.Recognize

    For Each term As String In smartTagDemo.Terms
        ' Search the text for the current smart tag term.
        Dim index As Integer = text.IndexOf(term, 0)

        While (index >= 0)
            ' Create a smart tag token and a property bag for the recognized term.
            Dim propertyBag As ISmartTagProperties = site.GetNewPropertyBag()

            ' Write a new property value.
            Dim key As String = "Key1"
            propertyBag.Write(key, DateTime.Now.ToString())

            ' Attach the smart tag to the term in the document
            context.PersistTag(index, term.Length, propertyBag)

            ' Increment the index and then find the next instance of the smart tag term.
            index += term.Length
            index = text.IndexOf(term, index)
        End While
    Next
End Sub

void ISmartTagExtension.Recognize(string text, ISmartTagRecognizerSite site, ISmartTagTokenList tokenList, 
    SmartTagRecognizeContext context)
{

    foreach (string term in smartTagDemo.Terms)
    {
        // Search the text for the current smart tag term.
        int index = text.IndexOf(term, 0);

        while (index >= 0)
        {
            // Create a smart tag token and a property bag for the recognized term.
            ISmartTagProperties propertyBag = site.GetNewPropertyBag();

            // Write a new property value.
            string key = "Key1";
            propertyBag.Write(key, DateTime.Now.ToString());

            // Attach the smart tag to the term in the document
            context.PersistTag(index, term.Length, propertyBag);

            // Increment the index and then find the next instance of the smart tag term.
            index += term.Length;
            index = text.IndexOf(term, index);
        }
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

SmartTagRecognizeContext Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via