Sdílet prostřednictvím

Návod: Vytvoření vlastní karty pomocí xml pásu karet

  • Článek

Tento názorný postup ukazuje, jak vytvořit vlastní kartu pásu karet pomocí položky pásu karet (XML).

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentů a projekty doplňků VSTO pro následující aplikace: Excel; InfoPath 2013 a InfoPath 2010; Aplikace outlook; Powerpoint; Projektu; Aplikace visio; Slovo. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Tento návod znázorňuje následující úlohy:

  • Přidání tlačítek na kartu Doplňky Karta Doplňky je výchozí karta definovaná v souboru XML pásu karet.

  • Automatizace systém Microsoft Office Wordu pomocí tlačítek na kartě Doplňky

Poznámka:

Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí sady Visual Studio.

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

Vytvoření projektu

Prvním krokem je vytvoření projektu doplňku Word VSTO. Později přizpůsobíte kartu Doplňky tohoto dokumentu.

Vytvoření nového projektu

  1. Vytvořte projekt doplňku wordu s názvem MyRibbonAddIn.

    Další informace naleznete v tématu Postupy: Vytváření projektů Office v sadě Visual Studio.

    Visual Studio otevře soubor kódu ThisAddIn.cs nebo ThisAddIn.vb a přidá projekt MyRibbonAddIn do Průzkumník řešení.

Vytvoření karty Doplňky VSTO

Pokud chcete vytvořit kartu Doplňky , přidejte do projektu položku pásu karet (XML ). Později v tomto názorném postupu přidáte na tuto kartu několik tlačítek.

Vytvoření karty Doplňky

  1. V nabídce Projekt klepněte na tlačítko Přidat novou položku.

  2. V dialogovém okně Přidat novou položku vyberte pás karet (XML).

  3. Změňte název nového pásu karet na MyRibbon a klikněte na Přidat.

    Soubor MyRibbon.cs nebo MyRibbon.vb se otevře v návrháři. Do projektu se přidá také soubor XML s názvem MyRibbon.xml .

  4. V Průzkumník řešení klepněte pravým tlačítkem myši ThisAddin.cs nebo ThisAddin.vb a potom klepněte na tlačítko Zobrazit kód.

  5. Do třídy ThisAddin přidejte následující kód. Tento kód přepíše metodu CreateRibbonExtensibilityObject a vrátí třídu XML pásu karet do aplikace Office lication.

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

  6. V Průzkumník řešení klepněte pravým tlačítkem myši na projekt MyRibbonAddIn a potom klepněte na tlačítko Sestavit. Ověřte, že se projekt sestaví bez chyb.

Přidání tlačítek na kartu Doplňky

Cílem tohoto doplňku VSTO je poskytnout uživatelům způsob, jak přidat často používaný text a konkrétní tabulku do aktivního dokumentu. Chcete-li poskytnout uživatelské rozhraní, přidejte dvě tlačítka na kartu Doplňky úpravou souboru XML pásu karet. Později v tomto názorném postupu definujete metody zpětného volání pro tlačítka. Další informace o souboru XML pásu karet naleznete v tématu Xml pásu karet.

Přidání tlačítek na kartu Doplňky

  1. V Průzkumník řešení klepněte pravým tlačítkem myši MyRibbon.xml a potom klepněte na tlačítko Otevřít.

  2. Nahraďte obsah elementu tab následujícím kódem XML. Tento KÓD XML změní popisek výchozí skupiny ovládacích prvků na Obsah 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čítek

Chcete-li provést akce, je nutné přidat onAction metody zpětného volání pro tlačítka Vložit text a Vložit tabulku , když na ně uživatel klikne. Další informace o metodách zpětného volání pro ovládací prvky pásu karet naleznete v tématu Xml pásu karet.

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

  1. V Průzkumník řešení klepněte pravým tlačítkem myši MyRibbon.cs nebo MyRibbon.vb a potom klepněte na tlačítko Otevřít.

  2. Do horní části souboru MyRibbon.cs nebo MyRibbon.vb přidejte následující kód. Tento kód vytvoří alias pro Microsoft.Office.Interop.Word obor názvů.

    using Word = Microsoft.Office.Interop.Word;

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

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

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

    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í doplňku VSTO

Když projekt spustíte, word se otevře a na pásu karet se zobrazí karta s názvem Doplňky . Klikněte na tlačítka Vložit text a Vložit tabulku na kartě Doplňky a otestujte kód.

Testování doplňku VSTO

  1. Stisknutím klávesy F5 spusťte projekt.

  2. Ověřte, že je na pásu karet zobrazená karta Doplňky .

  3. Klikněte na kartu Doplňky .

  4. Ověřte, že je skupina Obsahu viditelná na pásu karet.

  5. Klikněte na tlačítko Vložit text ve skupině Obsah.

    Řetězec se přidá do dokumentu v aktuálním umístění kurzoru.

  6. Klikněte na tlačítko Vložit tabulku ve skupině Obsah.

    Do dokumentu se přidá tabulka v aktuálním umístění kurzoru.

Další kroky

Další informace o přizpůsobení uživatelského rozhraní Office najdete v těchto tématech:

  • Přizpůsobení pásu karet jiné aplikace Office licace Další informace o aplikacích, které podporují přizpůsobení pásu karet, najdete v tématu Přehled pásu karet.

  • Pás karet aplikace Office lication můžete přizpůsobit pomocí Návrháře pásu karet. Další informace naleznete v tématu Návrhář pásu karet.

  • Vytvořte podokno vlastních akcí. Další informace najdete v tématu Přehled podokna Akce.

  • Přizpůsobte uživatelské rozhraní aplikace Microsoft Office Outlook pomocí oblastí formulářů aplikace Outlook. Další informace naleznete v tématu Návod: Návrh oblasti formuláře aplikace Outlook.

Související obsah