Návod: Vytvoření vlastní karty pomocí kódu XML pásu karet

Článek
05/16/2015

Tento návod ukazuje, jak vytvořit vlastní kartu pásu karet Pásu karet (XML) zboží.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v těchto aplikacích: Excel 2013 a Excel 2010, InfoPath 2013 a InfoPath 2010, Outlook 2013 a Outlook 2010, PowerPoint 2013 a PowerPoint 2010, Project 2013 a Project 2010, Visio 2013 a Visio 2010, Word 2013 a Word 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Tento návod ilustruje následující úkoly:

Přidání tlačítka Doplňky kartu.Doplňky karta je výchozí kartu, která je definována v souboru XML pásu karet.
Automatizace pomocí tlačítek v aplikaci Microsoft Office Word Doplňky kartu.

[!POZNÁMKA]

Váš počítač může zobrazit jiné názvy nebo umístění pro některé prvky uživatelského rozhraní sady Visual Studio v následujících pokynech.Tyto prvky jsou určeny verzí aplikace Visual Studio a použitým nastavením.Další informace naleznete v tématu Přizpůsobení nastavení pro vývoj v sadě Visual Studio.

Požadavky

Chcete-li dokončit tento návod, potřebujete následující komponenty:

Edice Visual Studia 2013, která zahrnuje nástroje Microsoft Office Developer Tools. Další informace najdete v tématu Konfigurace počítače pro vývoj řešení pro systém Office.
Word 2010 nebo Word 2013.

odkaz na video Související video ukázku naleznete v tématu jak I: použít Návrhář pásu karet přizpůsobení pásu karet aplikace Excel?.

Vytváření projektu

První krok je vytvořit projekt doplňku aplikace Word.Bude později upravit Doplňky kartu tohoto dokumentu.

Vytvoření nového projektu

Vytvořit Word - v projektu s názvem MyRibbonAddIn.

Další informace naleznete v tématu Postupy: Vytváření projektů pro systém Office v prostředí Visual Studio.

Visual StudioOtevře ThisAddIn.cs nebo ThisAddIn.vb soubor kódu a přidá MyRibbonAddIn projektu Průzkumníku.

Vytvoření karty doplňky

Vytvořit Doplňky karta, přidat Pásu karet (XML) položku v projektu.Dále v tomto návodu přidáte některá tlačítka na této kartě.

Vytvořit kartu doplňky

V nabídce Projekt klikněte na příkaz Přidat novou položku.
V Přidat novou položku dialogovém Pásu karet (XML).
Změňte název nové pásu karet na MyRibbona na Přidat.

MyRibbon.cs nebo MyRibbon.vb soubor se otevře v návrháři.Soubor XML s názvem MyRibbon.xml je také přidán do projektu.
V Průzkumníku, klepněte pravým tlačítkem ThisAddin.cs nebo ThisAddin.vba klepněte na tlačítko Zobrazení kódu.

Následující kód přidejte ThisAddin třídy.Tento kód přepíše CreateRibbonExtensibilityObject metoda a vrátí XML pásu karet třídy aplikace sady Office.

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
Microsoft.Office.Core.IRibbonExtensibility
    Return New MyRibbon()
End Function

protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
{
    return new MyRibbon();
}

V Průzkumníku, klepněte pravým tlačítkem myši MyRibbonAddIn projektu a potom klepněte na sestavení.Ověřte, že projekt sestaví bez chyb.

Přidání tlačítka na kartě Doplňky

Cílem tohoto doplňku je poskytnout uživatelům způsob, jak přidat vysvětlující text a určité tabulky aktivního dokumentu.Poskytovat uživatelské rozhraní přidat dvě tlačítka Doplňky kartě změnou souboru XML pásu karet.Dále v tomto návodu budete definovat metody zpětného volání pro tlačítka.Další informace o souboru XML pásu karet naleznete v Pás karet – XML.

Přidání tlačítka na kartě Doplňky

V Průzkumníku, klepněte pravým tlačítkem MyRibbon.xml a potom klepněte na tlačítko Open.

Nahraďte obsah tab element s následujícím XML.Tento XML změní výchozí skupiny ovládací prvek popisek obsahu, a přidá dvě nová tlačítka s popisky Vložit Text a Vložit tabulku.

<tab idMso="TabAddIns">
    <group id="ContentGroup" label="Content">
        <button id="textButton" label="Insert Text"
             screentip="Text" onAction="OnTextButton"
             supertip="Inserts text at the cursor location."/>
        <button id="tableButton" label="Insert Table"
             screentip="Table" onAction="OnTableButton"
             supertip="Inserts a table at the cursor location."/>
    </group>
</tab>

Automatizace dokumentu pomocí tlačítka

Musíte přidat onAction metody zpětného volání Vložit Text a Vložit tabulku tlačítka provádět akce, když uživatel klepne na ně.Další informace o metody zpětného volání pro ovládací prvky pásu karet, viz Pás karet – XML.

Přidání metod zpětného volání pro tlačítka

V Průzkumníku, klepněte pravým tlačítkem MyRibbon.cs nebo MyRibbon.vba klepněte na tlačítko Open.
Přidejte následující kód k horní části MyRibbon.cs nebo MyRibbon.vb souboru.Tento kód vytvoří alias Microsoft.Office.Interop.Word oboru názvů.
```
Imports Word = Microsoft.Office.Interop.Word
```
```
using Word = Microsoft.Office.Interop.Word;
```

Přidejte následující metodu MyRibbon třídy.Toto je metoda pro zpětné volání Vložit Text tlačítko, které přidá řetězec do aktuálního umístění kurzoru v aktivním dokumentu.

Public Sub OnTextButton(ByVal control As Office.IRibbonControl)
    Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
    currentRange.Text = "This text was added by the Ribbon." 
End Sub

public void OnTextButton(Office.IRibbonControl control)
{
    Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
    currentRange.Text = "This text was added by the Ribbon.";
}

Přidejte následující metodu MyRibbon třídy.Toto je metoda pro zpětné volání Vložit tabulku tlačítko, které přidá do tabulky aktivního dokumentu na aktuální pozici kurzoru.

Public Sub OnTableButton(ByVal control As Office.IRibbonControl)
    Dim missing As Object = System.Type.Missing

    Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
    Dim newTable As Word.Table = Globals.ThisAddIn.Application.ActiveDocument.Tables.Add( _
               currentRange, 3, 4)

    ' Get all of the borders except for the diagonal borders. 
    Dim borders() As Word.Border = New Word.Border(6) {}
    borders(0) = newTable.Borders(Word.WdBorderType.wdBorderLeft)
    borders(1) = newTable.Borders(Word.WdBorderType.wdBorderRight)
    borders(2) = newTable.Borders(Word.WdBorderType.wdBorderTop)
    borders(3) = newTable.Borders(Word.WdBorderType.wdBorderBottom)
    borders(4) = newTable.Borders(Word.WdBorderType.wdBorderHorizontal)
    borders(5) = newTable.Borders(Word.WdBorderType.wdBorderVertical)

    ' Format each of the borders. 
    For Each border As Word.Border In borders
        border.LineStyle = Word.WdLineStyle.wdLineStyleSingle
        border.Color = Word.WdColor.wdColorBlue
    Next 
End Sub

public void OnTableButton(Office.IRibbonControl control)
{
    object missing = System.Type.Missing;
    Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
    Word.Table newTable = Globals.ThisAddIn.Application.ActiveDocument.Tables.Add(
    currentRange, 3, 4, ref missing, ref missing);

    // Get all of the borders except for the diagonal borders.
    Word.Border[] borders = new Word.Border[6];
    borders[0] = newTable.Borders[Word.WdBorderType.wdBorderLeft];
    borders[1] = newTable.Borders[Word.WdBorderType.wdBorderRight];
    borders[2] = newTable.Borders[Word.WdBorderType.wdBorderTop];
    borders[3] = newTable.Borders[Word.WdBorderType.wdBorderBottom];
    borders[4] = newTable.Borders[Word.WdBorderType.wdBorderHorizontal];
    borders[5] = newTable.Borders[Word.WdBorderType.wdBorderVertical];

    // Format each of the borders. 
    foreach (Word.Border border in borders)
    {
        border.LineStyle = Word.WdLineStyle.wdLineStyleSingle;
        border.Color = Word.WdColor.wdColorBlue;
    }
}

Testování doplněk

Při spuštění aplikace Word otevře a kartu s názvem projektu Doplňky se zobrazí na pásu karet.Klepněte Vložit Text a Vložit tabulku na tlačítka Doplňky kartu k testování kódu.

Testování doplněk

Stisknutím klávesy F5 spustit projektu.
Potvrdit, že Doplňky je karta na pásu karet.
Klepněte Doplňky kartu.
Potvrdit, že obsahu skupina je zobrazena na pásu karet.
Klepněte Vložit Text tlačítko na obsahu skupiny.

Řetězec je přidán do aktuálního umístění kurzoru dokumentu.
Klepněte Vložit tabulku tlačítko na obsahu skupiny.

Tabulka je přidán do aktuálního umístění kurzoru dokumentu.

Další kroky

Další informace o přizpůsobení uživatelského rozhraní sady Office z těchto témat:

Přizpůsobte pás karet do jiné aplikace sady Office.Další informace o aplikacích, které podporují přizpůsobení pásu karet, viz Přehled pásu karet.
Přizpůsobení pásu karet aplikace sady Office pomocí Návrhář pásu karet.Další informace naleznete v tématu Návrhář pásu karet.
Vytvořte vlastní akce podokna.Další informace naleznete v tématu Přehled podokna akcí.
Přizpůsobte uživatelské rozhraní z aplikace Microsoft Office Outlook pomocí oblastí formulářů aplikace Outlook.Další informace naleznete v tématu Návod: Návrh oblasti formuláře aplikace Outlook.

Viz také

Sdílet prostřednictvím

Návod: Vytvoření vlastní karty pomocí kódu XML pásu karet

Požadavky

Vytváření projektu

Vytvoření nového projektu

Vytvoření karty doplňky

Vytvořit kartu doplňky

Přidání tlačítka na kartě Doplňky

Přidání tlačítka na kartě Doplňky

Automatizace dokumentu pomocí tlačítka

Přidání metod zpětného volání pro tlačítka

Testování doplněk

Testování doplněk

Další kroky

Viz také

Úkoly

Koncepty

Další zdroje

Další materiály