Action – rozhraní

Představuje akci inteligentních značek v sešitu aplikace Excel, který je přizpůsoben pomocí nástroje Office vývoj v aplikaci Visual Studio.

Obor názvů:  Microsoft.Office.Tools.Excel
Sestavení:  Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
<GuidAttribute("37e25b46-6941-4833-9b08-e692cf461982")> _
Public Interface Action _
    Inherits ActionBase

[GuidAttribute("37e25b46-6941-4833-9b08-e692cf461982")]
public interface Action : ActionBase

Typ Action zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Caption	Získá nebo nastaví název akce, jako je zobrazena v nabídce inteligentních značek. Tento typ člena je určen pouze pro použití v projektech systému Microsoft Office 2007. V systému Office 2010 již nejsou inteligentní značky používány. . (Zděděno z ActionBase.)

Nahoru

Události

	Název	Popis
	BeforeCaptionShow	Vyvolá se po klepnutí na ikonu inteligentní značky a před inteligentních značek se zobrazí nabídka. Tento typ člena je určen pouze pro použití v projektech systému Microsoft Office 2007. V systému Office 2010 již nejsou inteligentní značky používány. .
	Click	Nastane v případě akce v nabídce inteligentních značek. Tento typ člena je určen pouze pro použití v projektech systému Microsoft Office 2007. V systému Office 2010 již nejsou inteligentní značky používány. .

Nahoru

Poznámky

Akce jsou dostupné v místní nabídce inteligentní značky možnosti rozpoznané inteligentní značky určitého typu.Vytvořit akci, použijte Globals.Factory.CreateAction metoda vytvořit Action 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 naleznete v tématu Přehled nástrojů Visual Studio Tools for Office runtime.

Použití

Tento typ je určen pro použití pouze v projektech aplikace Excel 2007.Inteligentní značky jsou zastaralé v aplikaci Excel 2010.

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených pro rozhraní .NET Framework 4 a .NET Framework 4.5. V projektech cílených pro rozhraní .NET Framework 3.5 může mít tento typ jiné členy a ukázky kódu, poskytnuté pro tento typ, nemusejí fungovat. Dokumentaci k tomuto typu projektů cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k sadě Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

Následující příklad kódu vytvoří SmartTag se Action rozpoznává pojem "prodej" a regulární výraz "ssue\s\d [I|i] {5,6}".Akce upraví titulek nabídka Akce v době běhu a zobrazí adresu rozpoznaného textu.Chcete-li testovat příklad, zadejte slovo "prodej" v jedné buňce a řetězec "vydávání 12345" v jiné buňce a potom zkuste akce inteligentní značky.

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 Sub DisplayAddress_BeforeCaptionShow(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Excel.ActionEventArgs) _
    Handles DisplayAddress.BeforeCaptionShow

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

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

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

    Dim smartTagAddress As String = e.Range.Address( _
        ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("The recognized text '" & e.Text & _
            "' is at range " & smartTagAddress)
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);
}

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

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

void DisplayAddress_Click(object sender, 
    Microsoft.Office.Tools.Excel.ActionEventArgs e)
{
    string smartTagAddress = e.Range.get_Address(Excel.XlReferenceStyle.xlA1);
    System.Windows.Forms.MessageBox.Show("The recognized text '" + e.Text +
        "' is at range " + smartTagAddress);
}

Viz také

Referenční dokumentace

Microsoft.Office.Tools.Excel – obor názvů

SmartTag