Interfejs SmartTag

Artykuł
05/08/2013

Reprezentuje tagów inteligentnych w dokumencie programu Word, który jest dostosowany za pomocą narzędzi programistycznych pakietu Office w programie Visual Studio.

Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
<GuidAttribute("2b90a8e2-4e6c-4c27-bd35-a6ba7b344223")> _
Public Interface SmartTag _
    Inherits SmartTagBase

[GuidAttribute("2b90a8e2-4e6c-4c27-bd35-a6ba7b344223")]
public interface SmartTag : SmartTagBase

Typ SmartTag uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	Actions	Pobiera lub ustawia tablicę akcje, które są udostępniane przez tag inteligentny. Ten typ lub element członkowski jest przeznaczony do stosowania wyłącznie w projektach dla systemu Microsoft Office 2007. W systemie Office 2010 tagi inteligentne nie są już używane. . (Odziedziczone z SmartTagBase).
	Caption	Pobiera nazwę tagu inteligentnego. Ten typ lub element członkowski jest przeznaczony do stosowania wyłącznie w projektach dla systemu Microsoft Office 2007. W systemie Office 2010 tagi inteligentne nie są już używane. . (Odziedziczone z SmartTagBase).
	DefaultExtension	Pobiera domyślne rozszerzenie dla tego SmartTag obiektu. Ten typ lub element członkowski jest przeznaczony do stosowania wyłącznie w projektach dla systemu Microsoft Office 2007. W systemie Office 2010 tagi inteligentne nie są już używane. .
	Expressions	Pobiera kolekcja wyrażeń regularnych, które będą rozpoznawać tag inteligentny. Ten typ lub element członkowski jest przeznaczony do stosowania wyłącznie w projektach dla systemu Microsoft Office 2007. W systemie Office 2010 tagi inteligentne nie są już używane. . (Odziedziczone z SmartTagBase).
	Extension	Pobiera niestandardowego rozszerzenia dla tego SmartTag obiektu.
	SmartTagType	Pobiera obszaru nazw, który działa jako identyfikator unikatowy dla tagu inteligentnego. Ten typ lub element członkowski jest przeznaczony do stosowania wyłącznie w projektach dla systemu Microsoft Office 2007. W systemie Office 2010 tagi inteligentne nie są już używane. . (Odziedziczone z SmartTagBase).
	Terms	Pobiera kolekcja literały ciągów znaków, które będą rozpoznawać tag inteligentny. Ten typ lub element członkowski jest przeznaczony do stosowania wyłącznie w projektach dla systemu Microsoft Office 2007. W systemie Office 2010 tagi inteligentne nie są już używane. . (Odziedziczone z SmartTagBase).

Początek

Metody

	Nazwa	Opis
	Remove	Usuwa rozpoznawania wyrażenia regularnego z tagu inteligentnego. Ten typ lub element członkowski jest przeznaczony do stosowania wyłącznie w projektach dla systemu Microsoft Office 2007. W systemie Office 2010 tagi inteligentne nie są już używane. . (Odziedziczone z SmartTagBase).

Początek

Uwagi

Aby utworzyć tag inteligentny, użyj Globals.Factory.CreateSmartTag metoda tworzenia SmartTag obiektu.

[!UWAGA]

Ten interfejs jest implementowany przez Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz Visual Studio Tools dla pakietu Office, omówienie Runtime.

Użycie

Tego typu ma być używany tylko w projektach programu Word 2007.Tagi inteligentne zostały zaniechane w programie Word 2010.

Przykłady

Poniższy przykład kodu pokazuje jak utworzyć tag inteligentny.Akcja tagu inteligentnego modyfikuje caption menu akcji w czasie wykonywania i wyświetla położenie tekstu, który został rozpoznany.

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

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());
}

Zobacz też

Informacje

Przestrzeń nazw Microsoft.Office.Tools.Word

Udostępnij za pośrednictwem