Método ApplicationFactory.CreateSmartTag

Artigo
05/21/2013

Cria um objeto de SmartTag que representa uma marca inteligente em uma planilha.Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. Marcas inteligentes estão preteridas no Office 2010.
.

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

Sintaxe

'Declaração
Function CreateSmartTag ( _
    smartTagType As String, _
    caption As String, _
    extension As ISmartTagExtension _
) As SmartTag

SmartTag CreateSmartTag(
    string smartTagType,
    string caption,
    ISmartTagExtension extension
)

Parâmetros

smartTagType
Tipo: System.String
Um identificador exclusivo para a marca inteligente, composta de um URI de namespace e um nome de tipo de marca separado por um sinal numérico (#).

caption
Tipo: System.String
O nome de marca inteligente, que é exibida no menu de marca inteligente.

extension
Tipo: Microsoft.Office.Tools.Excel.ISmartTagExtension
Opcional.Um objeto de extensão que define um manipulador personalizado para a marca inteligente.

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.SmartTag
A nova marca inteligente.

Exceções

Exceção	Condição
ArgumentException	smartTagType ou caption são nulluma referência nula (Nothing no Visual Basic) ou vazio, ou smartTagType é inválido.

Comentários

Um exemplo de uma cadeia de caracteres válido para o parâmetro de smartTagType é http://smarttags.contoso.com#TagName.Uma cadeia de caracteres bem formada do tipo de marca inteligente não contiver espaço em branco, e inicia com uma letra (a-z, A-Z), um sublinhado (_), ou dois-pontos (:).

Exemplos

O exemplo de código a seguir demonstra como criar uma marca inteligente e uma ação em um projeto do suplemento do excel.Para usar este exemplo, execute o código de classe de ThisAddIn .

WithEvents displayAddress As Microsoft.Office.Tools.Excel.Action

Private Sub AddSmartTag()

    Dim smartTagDemo As Microsoft.Office.Tools.Excel.SmartTag = _
        Globals.Factory.CreateSmartTag(
        "www.microsoft.com/Demo#DemoSmartTag",
        "Demonstration Smart Tag")

    ' Specify a term and an expression to recognize.
    smartTagDemo.Terms.Add("sale")
    smartTagDemo.Expressions.Add( _
        New System.Text.RegularExpressions.Regex( _
        "[I|i]ssue\s\d{5,6}"))

    displayAddress = Globals.Factory.CreateAction("To be replaced")

    ' Add the action to the smart tag.
    smartTagDemo.Actions = New Microsoft.Office.Tools.Excel.Action() { _
            displayAddress}

    ' Add the smart tag.
    Me.VstoSmartTags.Add(smartTagDemo)
End Sub

private Microsoft.Office.Tools.Excel.Action displayAddress;

private void AddSmartTag()
{
    Microsoft.Office.Tools.Excel.SmartTag smartTagDemo =
        Globals.Factory.CreateSmartTag(
            "www.microsoft.com/Demo#DemoSmartTag",
            "Demonstration Smart Tag");

    // Specify a term and an expression to recognize.
    smartTagDemo.Terms.Add("sale");
    smartTagDemo.Expressions.Add(
        new System.Text.RegularExpressions.Regex(
        @"[I|i]ssue\s\d{5,6}"));

    displayAddress = Globals.Factory.CreateAction("To be replaced");


    // Add the action to the smart tag.
    smartTagDemo.Actions = new Microsoft.Office.Tools.Excel.Action[] { 
        displayAddress };

    // Add the smart tag.
    this.VstoSmartTags.Add(smartTagDemo);

    displayAddress.BeforeCaptionShow += new 
        Microsoft.Office.Tools.Excel.BeforeCaptionShowEventHandler(
        DisplayAddress_BeforeCaptionShow);

    displayAddress.Click += new 
        Microsoft.Office.Tools.Excel.ActionClickEventHandler(
        DisplayAddress_Click);
}

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

ApplicationFactory Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via