Genomgång: Skapa en anpassad flik med hjälp av XML i menyfliksområdet

Den här genomgången visar hur du skapar en anpassad Ribbon-flik med hjälp av Ribbon (XML)-objektet.

Gäller för: Informationen i det här avsnittet gäller för projekt på dokumentnivå och VSTO-tilläggsprojekt för följande program: Excel; InfoPath 2013 och InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Mer information finns i Funktioner som är tillgängliga efter Office-program och projekttyp.

I den här genomgången tas följande aktiviteter upp:

  • Lägga till knappar på fliken Tillägg . Fliken Tillägg är standardfliken som definieras i XML-filen i menyfliksområdet.

  • Automatisera Microsoft Office Word med hjälp av knapparna på fliken Tillägg .

Anmärkning

Datorn kan visa olika namn eller platser för vissa av Visual Studio-användargränssnittselementen i följande instruktioner. Den Visual Studio-utgåva som du har och de inställningar som du använder avgör dessa element. Mer information finns i Anpassa Visual Studio IDE.

Förutsättningar

Du behöver följande komponenter för att slutföra den här genomgången:

Skapa projektet

Det första steget är att skapa ett Word VSTO-tilläggsprojekt. Du kommer senare att anpassa fliken Tillägg i det här dokumentet.

Skapa ett nytt projekt

  1. Skapa ett Word-tilläggsprojekt med namnet MyRibbonAddIn.

    Mer information finns i Så här skapar du Office-projekt i Visual Studio.

    Visual Studio öppnar kodfilen ThisAddIn.cs eller ThisAddIn.vb och lägger till Projektet MyRibbonAddIn i Solution Explorer.

Skapa fliken VSTO-tillägg

Om du vill skapa fliken Tillägg lägger du till ett XML-objekt(Menyfliksområde) i projektet. Senare i den här genomgången lägger du till några knappar på den här fliken.

Så här skapar du fliken Tillägg

  1. På Projekt-menyn klickar du på Lägg till nytt objekt.

  2. I dialogrutan Lägg till nytt objekt väljer du Menyfliksområde (XML).

  3. Ändra namnet på det nya menyfliksområdet till MyRibbon och klicka på Lägg till.

    Filen MyRibbon.cs eller MyRibbon.vb öppnas i designern. En XML-fil med namnet MyRibbon.xml läggs också till i projektet.

  4. Högerklicka på ThisAddin.cs eller ThisAddin.vb i Solution Explorer och klicka sedan på Visa kod.

  5. Lägg till följande kod i klassen ThisAddin . Den här koden åsidosätter CreateRibbonExtensibilityObject metoden och returnerar XML-klassen Ribbon till Office-programmet.

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

  6. Högerklicka på projektet MyRibbonAddIn i Solution Explorer och klicka sedan på Skapa. Kontrollera att projektet byggs utan fel.

Lägg till knappar på fliken Tillägg

Målet med det här VSTO-tillägget är att ge användarna ett sätt att lägga till standardtext och en specifik tabell i det aktiva dokumentet. Om du vill ange användargränssnittet lägger du till två knappar på fliken Tillägg genom att ändra XML-filen i menyfliksområdet. Senare i den här genomgången definierar du återanropsmetoder för knapparna. Mer information om XML-filen i menyfliksområdet finns i Menyfliksområdets XML.

Så här lägger du till knappar på fliken Tillägg

  1. Högerklicka på MyRibbon.xml i Solution Explorer och klicka sedan på Öppna.

  2. Ersätt innehållet i flikelementet med följande XML. Den här XML-koden ändrar etiketten för standardkontrollgruppen till Innehåll och lägger till två nya knappar med etiketterna Infoga text och Infoga tabell.

    <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>

Automatisera dokumentet med hjälp av knapparna

Du måste lägga till onAction återkallningsmetoder för Infoga text och Infoga tabell-knapparna för att utföra åtgärder när användaren klickar på dem. Mer information om återanropsmetoder för menyflikskontroller finns i XML för menyfliksområdet.

Lägg till återkopplingsmetoder för knapparna

  1. Högerklicka på MyRibbon.cs eller MyRibbon.vb i Solution Explorer och klicka sedan på Öppna.

  2. Lägg till följande kod överst i filen MyRibbon.cs eller MyRibbon.vb . Den här koden skapar ett alias för Microsoft.Office.Interop.Word namnområdet.

    using Word = Microsoft.Office.Interop.Word;

  3. Lägg till följande metod i MyRibbon klassen. Det här är en motringningsmetod för knappen Infoga text som lägger till en sträng i det aktiva dokumentet på markörens aktuella plats.

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

  4. Lägg till följande metod i MyRibbon klassen. Det här är en motringningsmetod för knappen Infoga tabell som lägger till en tabell i det aktiva dokumentet på markörens aktuella plats.

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

Testa VSTO-tillägget

När du kör projektet öppnas Word och fliken namngiven Tillägg visas på menyfliksområdet. Klicka på knapparna Infoga text och Infoga tabell på fliken Tillägg för att testa koden.

Testa ditt VSTO-tillägg

  1. Tryck på F5 för att köra projektet.

  2. Bekräfta att fliken Tillägg visas i menyfliksområdet.

  3. Klicka på fliken Tillägg .

  4. Bekräfta att innehållsgruppen är synlig i menyfliksområdet.

  5. Klicka på knappen Infoga text i gruppen Innehåll .

    En sträng läggs till i dokumentet på markörens aktuella plats.

  6. Klicka på knappen Infoga tabell i gruppen Innehåll .

    En tabell läggs till i dokumentet på markörens aktuella plats.

Nästa steg

Du kan lära dig mer om hur du anpassar Office-användargränssnittet från följande ämnen:

Relaterat innehåll

  • Last updated on