Wskazówki: tworzenie kart niestandardowych za pomocą XML wstążki

Artykuł
06/10/2015

W tym instruktażu przedstawiono sposób tworzenia niestandardowej karty wstążki przy użyciu Wstążki (XML) przedmiotu.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji dla następujących aplikacji: Excel 2013 i Excel 2010; InfoPath 2013 i InfoPath 2010; Outlook 2013 i Outlook 2010; PowerPoint 2013 i PowerPoint 2010; Project 2013 i Project 2010; Visio 2013 i Visio 2010; Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

W tym instruktażu przedstawiono następujące zadania:

Dodawanie przycisków do Dodatki kartę.Dodatki karta jest tabulator domyślny, który jest zdefiniowany w pliku XML wstążki.
Automatyzacja programu Microsoft Office Word za pomocą przycisków na Dodatki kartę.

[!UWAGA]

Komputer może pokazać różne nazwy lub lokalizacje dla niektórych użytkowników programu Visual Studio elementów interfejsu w poniższych instrukcji.Wydanie programu Visual Studio, że masz i ustawienia, które możesz używać określenia tych elementów.Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Wymagania wstępne

Potrzebne do przeprowadzenia tego instruktażu następujące składniki:

Edycja programu Visual Studio 2013, która oferuje narzędzia deweloperskie pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz Konfigurowanie komputera do opracowywania rozwiązań pakietu Office.
Word 2010or Word 2013.

łącze do wideo Aby wyświetlić pokrewne wideo demonstracyjne, zobacz jak I: użyć projektanta wstążki do dostosowania wstążki w programie Excel?.

Tworzenie projektu

Pierwszym krokiem jest utworzenie Word-w projekcie.Później będzie można dostosować Dodatki kartę tego dokumentu.

Aby utworzyć nowy projekt

Tworzenie - w programie Word projekt o nazwie MyRibbonAddIn.

Aby uzyskać więcej informacji, zobacz Porady: tworzenie projektów Office w Visual Studio.

Visual StudioOtwiera ThisAddIn.cs lub ThisAddIn.vb kod pliku i dodaje MyRibbonAddIn projekt Solution Explorer.

Tworzenie karty dodatków

Aby utworzyć Dodatki kartę, dodać Wstążki (XML) element do projektu.Później w tym instruktażu będzie dodać przyciski do tej karty.

Aby utworzyć kartę Dodatki

Na Projekt menu, kliknij przycisk Dodaj nowy element.
W Dodaj nowy element okno dialogowe, wybierz Wstążki (XML).
Zmień nazwę nowej taśmy do MyRibboni kliknij przycisk Dodaj.

MyRibbon.cs lub MyRibbon.vb plik zostanie otwarty w projektancie.Plik XML o nazwie MyRibbon.xml jest również dodany do projektu.
W Solution Explorer, kliknij prawym przyciskiem myszy ThisAddin.cs lub ThisAddin.vb, a następnie kliknij przycisk Widok Kod.

Dodaj następujący kod do ThisAddin klasy.Zastępuje ten kod CreateRibbonExtensibilityObject metoda i zwraca wartość XML wstążki klasy do aplikacji pakietu 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();
}

W Solution Explorer, kliknij prawym przyciskiem myszy MyRibbonAddIn projektu, a następnie kliknij przycisk budować.Zweryfikuj, że projekt buduje się bez błędów.

Dodawanie przycisków na karcie Dodatki

Cel ten dodatek jest dać użytkownikom sposób, aby dodać tekst standardowy i określonej tabeli do aktywnego dokumentu.Aby udostępnić interfejs użytkownika, należy dodać dwa przyciski, aby Dodatki kartę, modyfikując plik XML wstążki.Później w tym instruktażu określi metody wywołania zwrotnego dla przycisków.Aby uzyskać więcej informacji na temat pliku XML wstążki, zobacz XML — Wstążka.

Aby dodać przyciski na karcie Dodatki

W Solution Explorer, kliknij prawym przyciskiem myszy MyRibbon.xml , a następnie kliknij przycisk Otwórz.

Zastępowanie zawartości tab element z następujących XML.Ten XML zmienia etykieta domyślna grupa kontrolna do zawartości, i dodaje dwa nowe przyciski z etykietami Wstaw tekst i Wstaw tabelę.

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

Automatyzacja dokumentu za pomocą przycisków

Należy dodać onAction metod wywołania zwrotnego dla Wstaw tekst i Wstaw tabelę przyciski do wykonywania akcji, gdy użytkownik kliknie je.Aby uzyskać więcej informacji na temat metod wywołania zwrotnego dla formanty wstążki, zobacz XML — Wstążka.

Do dodawania metod wywołań zwrotnych dla przycisków

W Solution Explorer, kliknij prawym przyciskiem myszy MyRibbon.cs lub MyRibbon.vb, a następnie kliknij przycisk Otwórz.
Dodaj następujący kod do góry MyRibbon.cs lub MyRibbon.vb pliku.Kod ten tworzy alias dla Microsoft.Office.Interop.Word obszaru nazw.
```
Imports Word = Microsoft.Office.Interop.Word
```
```
using Word = Microsoft.Office.Interop.Word;
```

Dodaj następującą metodę do MyRibbon klasy.Jest to metoda wywołania zwrotnego dla Wstaw tekst przycisk, który dodaje ciąg aktywny dokument w bieżącej lokalizacji kursora.

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

Dodaj następującą metodę do MyRibbon klasy.Jest to metoda wywołania zwrotnego dla Wstaw tabelę przycisk, który dodaje tabeli do aktywnego dokumentu w bieżącej lokalizacji kursora.

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

Badania-dodatek

Po uruchomieniu projektu, program Word otwiera i kartę o nazwie Dodatki pojawia się na Wstążce.Kliknij przycisk Wstaw tekst i Wstaw tabelę przyciski na Dodatki kartę, aby przetestować kod.

Aby przetestować dodatek

Naciśnij klawisz F5, aby uruchomić projekt.
Potwierdzić, że Dodatki karta jest widoczna na Wstążce.
Kliknij przycisk Dodatki kartę.
Potwierdzić, że zawartości grupa jest widoczny na Wstążce.
Kliknij przycisk Wstaw tekst przycisk w zawartości grupy.

Ciąg jest dodawane do dokumentu w bieżącej lokalizacji kursora.
Kliknij przycisk Wstaw tabelę przycisk w zawartości grupy.

Tabela jest dodawane do dokumentu w bieżącej lokalizacji kursora.

Następne kroki

Można uzyskać więcej informacji na temat dostosowywania interfejsu użytkownika pakietu Office z tych tematów:

Dostosowywanie Wstążki różnych aplikacji pakietu Office.Aby uzyskać więcej informacji na temat aplikacji, które obsługują Dostosowywanie Wstążki, zobacz Wstążka ― Omówienie.
Dostosowywanie Wstążki aplikacji pakietu Office przy użyciu projektanta wstążki.Aby uzyskać więcej informacji, zobacz Projektant wstążki.
Utwórz okienko akcji niestandardowych.Aby uzyskać więcej informacji, zobacz Okienko akcji ― Omówienie.
Dostosowywanie interfejsu użytkownika Microsoft Office Outlook za pomocą regionów formularzy programu Outlook.Aby uzyskać więcej informacji, zobacz Wskazówki: projektowanie regionów formularzy programu Outlook.

Zobacz też

Udostępnij za pośrednictwem