SmartTag Rozhraní

Definice

Představuje inteligentní značku v dokumentu aplikace Word, který je přizpůsoben pomocí vývojářských nástrojů pro Office v sadě Visual Studio.

[System.Runtime.InteropServices.Guid("2b90a8e2-4e6c-4c27-bd35-a6ba7b344223")]
public interface SmartTag : Microsoft.Office.Tools.SmartTagBase
Atributy
Implementuje

Příklady

Následující příklad kódu ukazuje, jak vytvořit inteligentní značku. Akce inteligentních značek upraví titulek nabídky akce za běhu a zobrazí umístění rozpoznaného textu.

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

private void AddSmartTag()
{
    // Create the smart tag for .NET Framework 4 projects.
    Microsoft.Office.Tools.Word.SmartTag smartTagDemo =
        Globals.Factory.CreateSmartTag(
        "www.microsoft.com/Demo#DemoSmartTag",
        "Demonstration Smart Tag");

    // For .NET Framework 3.5 projects, use the following code to create the smart tag.
    // Microsoft.Office.Tools.Word.SmartTag smartTagDemo =
        // new Microsoft.Office.Tools.Word.SmartTag(
        //     "www.microsoft.com/Demo#DemoSmartTag",
        //     "Demonstration Smart Tag");

    // Specify the terms to recognize.
    smartTagDemo.Terms.Add("term");
    smartTagDemo.Terms.Add("recognize");

    // Create the action for .NET Framework 4 projects.
    displayAddress = Globals.Factory.CreateAction("To be replaced"); 

    // For .NET Framework 3.5 projects, use the following code to create the action.
    // displayAddress = new Microsoft.Office.Tools.Word.Action("To be replaced");

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

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

    displayAddress.BeforeCaptionShow += new
        Microsoft.Office.Tools.Word.BeforeCaptionShowEventHandler(
        displayAddress_BeforeCaptionShow);

    displayAddress.Click += new
        Microsoft.Office.Tools.Word.ActionClickEventHandler(
        displayAddress_Click);
}

void displayAddress_BeforeCaptionShow(object sender,
    Microsoft.Office.Tools.Word.ActionEventArgs e)
{
    Microsoft.Office.Tools.Word.Action clickedAction =
        sender as Microsoft.Office.Tools.Word.Action;

    if (clickedAction != null)
    {
        clickedAction.Caption = "Display the location of " +
            e.Text;
    }
}

void displayAddress_Click(object sender,
    Microsoft.Office.Tools.Word.ActionEventArgs e)
{
    int termStart = e.Range.Start;
    int termEnd = e.Range.End;
    System.Windows.Forms.MessageBox.Show("The recognized text '" + e.Text +
        "' begins at position " + termStart.ToString() +
        " and ends at position " + termEnd.ToString());
}
Private WithEvents displayAddress As Microsoft.Office.Tools.Word.Action

Private Sub AddSmartTag()

    ' Create the smart tag for .NET Framework 4 projects.
    Dim smartTagDemo As Microsoft.Office.Tools.Word.SmartTag = Globals.Factory.CreateSmartTag(
        "www.microsoft.com/Demo#DemoSmartTag",
        "Demonstration Smart Tag")

    ' For .NET Framework 3.5 projects, use the following code to create the smart tag.
    ' Dim smartTagDemo As New  _
    '     Microsoft.Office.Tools.Word.SmartTag( _
    '     "www.microsoft.com/Demo#DemoSmartTag", _
    '     "Demonstration Smart Tag")

    ' Specify the terms to recognize.
    smartTagDemo.Terms.Add("term")
    smartTagDemo.Terms.Add("recognize")

    ' Create the action for .NET Framework 4 projects.
    displayAddress = Globals.Factory.CreateAction("To be replaced")

    ' For .NET Framework 3.5 projects, use the following code to create the action.
    ' displayAddress = New Microsoft.Office.Tools.Word.Action("To be replaced")

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

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

Private Sub DisplayAddress_BeforeCaptionShow(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ActionEventArgs) _
    Handles displayAddress.BeforeCaptionShow

    Dim clickedAction As Microsoft.Office.Tools.Word.Action = _
        TryCast(sender, Microsoft.Office.Tools.Word.Action)

    If clickedAction IsNot Nothing Then
        clickedAction.Caption = "Display the location of " & e.Text
    End If
End Sub

Private Sub DisplayAddress_Click(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ActionEventArgs) _
    Handles displayAddress.Click

    Dim termStart As Integer = e.Range.Start
    Dim termEnd As Integer = e.Range.End
    MsgBox("The recognized text '" & e.Text & _
            "' begins at position " & termStart & _
            " and ends at position " & termEnd)
End Sub

Poznámky

Chcete-li vytvořit inteligentní značku, použijte Globals.Factory.CreateSmartTag metodu pro vytvoření SmartTag objektu.

Poznámka

Toto rozhraní je implementováno modulem Visual Studio Tools for Office Runtime. Rozhraní není určeno k implementaci do vašeho kódu. Další informace najdete v tématu Visual Studio Tools for Office Runtime přehled.

Využití

Tento typ je určený jenom pro použití v projektech pro Word 2007. Inteligentní značky jsou ve Wordu 2010 zastaralé.

Vlastnosti

Actions

Získá nebo nastaví pole akcí, které jsou zpřístupněné inteligentní značkou. Tento typ nebo člen je určený jenom pro projekty pro Microsoft Office 2007. V Office 2010 už se inteligentní značky nepoužívají..

(Zděděno od SmartTagBase)
Caption

Získá název inteligentní značky. Tento typ nebo člen je určený jenom pro projekty pro Microsoft Office 2007. V Office 2010 už se inteligentní značky nepoužívají..

(Zděděno od SmartTagBase)
DefaultExtension

Získá výchozí příponu tohoto SmartTag objektu. Tento typ nebo člen je určený jenom pro projekty pro Microsoft Office 2007. V Office 2010 už se inteligentní značky nepoužívají..

Expressions

Získá kolekci regulárních výrazů, které bude rozpoznána inteligentní značkou. Tento typ nebo člen je určený jenom pro projekty pro Microsoft Office 2007. V Office 2010 už se inteligentní značky nepoužívají..

(Zděděno od SmartTagBase)
Extension

Získá vlastní rozšíření pro tento SmartTag objekt.

SmartTagType

Získá obor názvů, který funguje jako jedinečný identifikátor inteligentní značky. Tento typ nebo člen je určený jenom pro projekty pro Microsoft Office 2007. V Office 2010 už se inteligentní značky nepoužívají..

(Zděděno od SmartTagBase)
Terms

Získá kolekci řetězcových literálů, které inteligentní značka rozpozná. Tento typ nebo člen je určený jenom pro projekty pro Microsoft Office 2007. V Office 2010 už se inteligentní značky nepoužívají..

(Zděděno od SmartTagBase)

Metody

Remove(Regex)

Odebere nástroj pro rozpoznávání regulárních výrazů z inteligentní značky. Tento typ nebo člen je určený jenom pro projekty pro Microsoft Office 2007. V Office 2010 už se inteligentní značky nepoužívají..

(Zděděno od SmartTagBase)

Platí pro