逐步解說：使用 Ribbon XML 來建立自訂索引標籤

本逐步解說示範如何使用 功能區 （XML） 項目來建立自訂功能區索引標籤。

適用於： 本主題中的資訊適用於下列應用程式的文件層級專案和 VSTO 增益集專案：Excel; InfoPath 2013 和 InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word。 如需詳細資訊，請參閱 Office 應用程式和專案類型所提供的功能。

本逐步解說將說明下列工作：

  • 將按鈕新增至 增益集 索引標籤。增益集 索引標籤是在功能區 XML 檔案中定義的預設索引標籤。

  • 使用 增益集 索引標籤上的按鈕，將 Microsoft Office Word 自動化。

備註

在下列指示的某些 Visual Studio 使用者介面項目中，您的電腦可能會顯示不同的名稱或位置： 您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。 如需詳細資訊，請參閱將 Visual Studio IDE 個人化。

先決條件

您需要下列組件才能完成本步驟解說：

建立專案

第一步是建立一個 Word VSTO 增益集專案。 您稍後將自訂本文件的 增益集 索引標籤。

建立新專案

  1. 建立名稱為 MyRibbonAddIn 的 Word 增益集專案。

    如需詳細資訊，請參閱 如何：在 Visual Studio 中建立 Office 專案。

    Visual Studio 會開啟 ThisAddIn.cs 或 ThisAddIn.vb 程式碼檔案，並將 MyRibbonAddIn 專案新增至 [方案總管]。

建立 VSTO 增益集頁籤

若要建立 [增益集] 索引標籤，請將 Ribbon(XML) 元件新增到專案中。 在本逐步解說的稍後部分，您將在此索引標籤中新增一些按鈕。

建立 [增益集] 索引標籤

  1. 在 [專案] 功能表上，按一下 [新增專案]。

  2. 在 [新增項目] 對話方塊中，選取 [功能區 (XML)]。

  3. 將新功能區的名稱變更為 MyRibbon，然後按一下 [新增]。

    MyRibbon.cs或MyRibbon.vb檔案會在設計工具中開啟。 名為 MyRibbon.xml 的 XML 檔案也會新增至您的專案。

  4. 在 [方案總管] 中，以滑鼠右鍵按一下 ThisAddin.cs 或 ThisAddin.vb，然後按一下 [ 檢視程式碼]。

  5. 將下列程式碼新增至 ThisAddin 類別。 此程式碼會覆寫 CreateRibbonExtensibilityObject 方法，並將功能區 XML 類別傳回給 Office 應用程式。

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

  6. 在 [方案總管] 中，以滑鼠右鍵按一下 MyRibbonAddIn 專案，然後按一下 [建置]。 確認專案建置時沒有錯誤。

將按鈕新增至 [增益集] 索引標籤

此 VSTO 增益集的目標是讓使用者能夠將樣板文字和特定表格新增至使用中的文件。 若要提供使用者介面，請修改功能區 XML 檔案，將兩個按鈕新增至 [增益集 ] 索引標籤。 在稍後的教學指南中，您將定義按鈕的回呼函數。 如需功能區 XML 檔案的詳細資訊，請參閱 功能區 XML。

若要將按鈕新增至 [增益集] 索引標籤

  1. 在 [方案總管] 中，以滑鼠右鍵按一下 MyRibbon.xml ，然後按一下 [ 開啟]。

  2. 將 標籤 元素的內容替換為下列 XML。 此 XML 會將預設控制項群組的標籤變更為 [內容]，並新增兩個新按鈕，標籤為 [插入文字 ] 和 [插入表格]。

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

使用按鈕將文件自動化

您必須新增 onAction[插入文字 ] 和 [插入表格 ] 按鈕的回呼方法，才能在使用者按一下它們時執行動作。 如需功能區控制項回呼方法的詳細資訊，請參閱 功能區 XML。

要為按鈕新增回呼方法

  1. 在 [方案總管] 中，以滑鼠右鍵按一下 [ MyRibbon.cs ] 或 [MyRibbon.vb]，然後按一下 [ 開啟]。

  2. 將下列程式碼新增至 MyRibbon.cs 或 MyRibbon.vb 檔案的頂端。 此程式碼會建立命名空間的 Microsoft.Office.Interop.Word 別名。

    using Word = Microsoft.Office.Interop.Word;

  3. 將下列方法新增至 MyRibbon 類別。 這是「 插入文字」 按鈕的回呼方法，可將字串新增至游標目前位置的作用中文件。

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

  4. 將下列方法新增至 MyRibbon 類別。 這是「 插入表格」 按鈕的回呼方法，可將表格新增至游標目前位置的作用中文件。

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

測試 VSTO 增益集

當您執行專案時，Word 會開啟，而且功能區上會出現名為 [增益集] 的索引標籤。 按一下 [增益集] 索引標籤上的 [插入文字] 和 [插入表格] 按鈕以測試程式碼。

要測試您的 VSTO 增益集

  1. 請按 F5 執行您的專案。

  2. 確認 [增益集] 索引標籤顯示在功能區上。

  3. 按一下 外掛程式 標籤。

  4. 確認 內容 群組顯示在功能區上。

  5. 按一下「內容」群組中的「插入文字」按鈕。

    字串會新增至游標目前位置的文件。

  6. 按一下「內容」群組中的「插入表格」按鈕。

    表格會新增至游標目前位置的文件中。

後續步驟

您可以從下列主題深入瞭解如何自訂 Office UI：

  • 自訂其他 Office 應用程式的功能區。 如需支援自訂功能區之應用程式的詳細資訊，請參閱 功能區概觀。

  • 使用功能區設計工具自訂 Office 應用程式的功能區。 如需詳細資訊，請參閱 功能區設計工具。

  • 建立自訂動作窗格。 如需詳細資訊，請參閱 動作窗格概觀。

  • 使用 Outlook 表單區域自訂 Microsoft Office Outlook 的 UI。 如需詳細資訊，請參閱 逐步解說：設計 Outlook 表單區域。

相關內容

  • Last updated on