Método ApplicationFactory.CreateSmartTag

Artigo
08/01/2011

Cria um SmartTag objeto que representa uma marca inteligente em um documento.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.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 por um URI de espaço para nome e uma marca digite o nome, separado por um sinal numérico (#).

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

extension
Tipo: Microsoft.Office.Tools.Word.ISmartTagExtension
Optional.Um objeto de extensão que define um reconhecedor personalizado para a marca inteligente.

Valor de retorno

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

Exceções

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

Comentários

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

Para obter mais informações sobre marcas inteligentes, consulte Visão geral sobre marcas inteligentes e Arquitetura de marcas inteligentes.

Exemplos

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

Dim simpleSmartTag As Microsoft.Office.Tools.Word.SmartTag =
    Globals.Factory.CreateSmartTag(
        "www.microsoft.com/Demo#DemoSmartTag",
        "Test Smart Tag")
Dim simpleAction As Microsoft.Office.Tools.Word.Action =
    Globals.Factory.CreateAction("Test Action")

simpleSmartTag.Terms.Add("blue")
simpleSmartTag.Actions = New Microsoft.Office.Tools.Word.Action() { _
    simpleAction}
Me.VstoSmartTags.Add(simpleSmartTag)

Microsoft.Office.Tools.Word.SmartTag simpleSmartTag =
    Globals.Factory.CreateSmartTag(
    "www.microsoft.com/Demo#DemoSmartTag",
    "Test Smart Tag");
Microsoft.Office.Tools.Word.Action simpleAction =
    Globals.Factory.CreateAction("Test Action");

simpleSmartTag.Terms.Add("blue");
simpleSmartTag.Actions = new Microsoft.Office.Tools.Word.Action[] { 
    simpleAction };
this.VstoSmartTags.Add(simpleSmartTag);

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

Compartilhar via