Udostępnij za pośrednictwem

Przewodnik: tworzenie karty niestandardowej przy użyciu kodu XML wstążki

  • Artykuł

W tym przewodniku pokazano, jak utworzyć niestandardową kartę wstążki przy użyciu elementu wstążki (XML).

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO dla następujących aplikacji: Excel; InfoPath 2013 i InfoPath 2010; Programu outlook; Powerpoint; Projektu; Visio; Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

W instruktażu przedstawiono następujące zagadnienia:

  • Dodawanie przycisków do karty Dodatki . Karta Dodatki to domyślna karta zdefiniowana w pliku XML wstążki.

  • Automatyzacja programu Microsoft Office Word przy użyciu przycisków na karcie Dodatki.

Uwaga

Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE programu Visual Studio.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

Tworzenie projektu

Pierwszym krokiem jest utworzenie projektu dodatku VSTO programu Word. Później dostosujesz kartę Dodatki tego dokumentu.

Aby utworzyć nowy projekt

  1. Utwórz projekt dodatku programu Word o nazwie MyRibbonAddIn.

    Aby uzyskać więcej informacji, zobacz How to: Create Office projects in Visual Studio (Jak tworzyć projekty pakietu Office w programie Visual Studio).

    Program Visual Studio otwiera plik kodu ThisAddIn.cs lub ThisAddIn.vb i dodaje projekt MyRibbonAddIn do Eksplorator rozwiązań.

Tworzenie karty Dodatków VSTO

Aby utworzyć kartę Dodatki , dodaj element wstążki (XML) do projektu. W dalszej części tego przewodnika dodasz kilka przycisków do tej karty.

Aby utworzyć kartę Dodatki

  1. W menu Project (Projekt) kliknij pozycję Add New Item (Dodaj nowy element).

  2. W oknie dialogowym Dodawanie nowego elementu wybierz pozycję Wstążka (XML).

  3. Zmień nazwę nowej wstążki na MyRibbon, a następnie kliknij przycisk Dodaj.

    Plik MyRibbon.cs lub MyRibbon.vb zostanie otwarty w projektancie. Plik XML o nazwie MyRibbon.xml jest również dodawany do projektu.

  4. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy pozycję ThisAddin.cs lub ThisAddin.vb, a następnie kliknij polecenie Wyświetl kod.

  5. Dodaj następujący kod do klasy ThisAddin . Ten kod zastępuje metodę CreateRibbonExtensibilityObject i zwraca klasę XML wstążki do aplikacja pakietu Office licacji.

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

  6. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt MyRibbonAddIn, a następnie kliknij polecenie Kompiluj. Sprawdź, czy projekt jest kompilujący bez błędów.

Dodawanie przycisków na karcie Dodatki

Celem tego dodatku VSTO jest zapewnienie użytkownikom możliwości dodawania tekstu kociołowego i określonej tabeli do aktywnego dokumentu. Aby udostępnić interfejs użytkownika, dodaj dwa przyciski na karcie Dodatki , modyfikując plik XML wstążki. W dalszej części tego przewodnika zdefiniujesz metody wywołania zwrotnego dla przycisków. Aby uzyskać więcej informacji na temat pliku XML wstążki, zobacz Plik XML wstążki.

Aby dodać przyciski do karty Dodatki

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik MyRibbon.xml, a następnie kliknij polecenie Otwórz.

  2. Zastąp zawartość elementu tab następującym kodem XML. Ten kod XML zmienia etykietę domyślnej grupy kontrolnej na Zawartość 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>

Automatyzowanie dokumentu przy użyciu przycisków

Aby wykonać akcje po kliknięciu przez użytkownika, należy dodać onAction metody wywołania zwrotnego dla przycisków Wstaw tekst i Wstaw tabelę. Aby uzyskać więcej informacji na temat metod wywołania zwrotnego dla kontrolek wstążki, zobacz Plik XML wstążki.

Aby dodać metody wywołania zwrotnego dla przycisków

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik MyRibbon.cs lub MyRibbon.vb, a następnie kliknij przycisk Otwórz.

  2. Dodaj następujący kod na początku pliku MyRibbon.cs lub MyRibbon.vb . Ten kod tworzy alias dla Microsoft.Office.Interop.Word przestrzeni nazw.

    using Word = Microsoft.Office.Interop.Word;

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

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

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

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

Testowanie dodatku VSTO

Po uruchomieniu projektu program Word zostanie otwarty, a na wstążce zostanie wyświetlona karta o nazwie Dodatki . Kliknij przyciski Wstaw tekst i Wstaw tabelę na karcie Dodatki, aby przetestować kod.

Aby przetestować dodatek VSTO

  1. Naciśnij klawisz F5 , aby uruchomić projekt.

  2. Upewnij się, że karta Dodatki jest widoczna na wstążce.

  3. Kliknij kartę Dodatki .

  4. Upewnij się, że grupa Zawartość jest widoczna na wstążce.

  5. Kliknij przycisk Wstaw tekst w grupie Zawartość.

    Ciąg jest dodawany do dokumentu w bieżącej lokalizacji kursora.

  6. Kliknij przycisk Wstaw tabelę w grupie Zawartość.

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

Następne kroki

Więcej informacji na temat dostosowywania interfejsu użytkownika pakietu Office można znaleźć w następujących tematach:

  • Dostosuj wstążkę innej aplikacja pakietu Office licacji. Aby uzyskać więcej informacji na temat aplikacji obsługujących dostosowywanie wstążki, zobacz Omówienie wstążki.

  • Dostosuj wstążkę aplikacja pakietu Office licacji przy użyciu Projektant wstążki. Aby uzyskać więcej informacji, zobacz Projektant wstążki.

  • Utwórz okienko akcji niestandardowych. Aby uzyskać więcej informacji, zobacz Omówienie okienka akcji.

  • Dostosowywanie interfejsu użytkownika programu Microsoft Office Outlook przy użyciu regionów formularzy programu Outlook. Aby uzyskać więcej informacji, zobacz Przewodnik: projektowanie regionu formularza programu Outlook.

Powiązana zawartość