逐步解說：使用功能區 XML 建立自定義索引標籤

  • 發行項

本逐步解說示範如何使用功能區 （XML） 專案建立自定義功能區索引標籤。

適用於： 本主題中的資訊適用於下列應用程式的檔層級專案和 VSTO 載入宏專案：Excel;InfoPath 2013 和 InfoPath 2010;前景;幻燈片;專案;Visio;詞。 如需詳細資訊，請參閱 Office 應用程式 lication 和項目類型所提供的功能。

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

  • 將按鈕新增至 [ 載入宏] 索引標籤 。[ 載入宏] 索引 標籤是功能區 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 載入宏索引標籤

若要建立 [載入宏] 索引標籤，請將功能區 （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 取代 Tab 元素的內容。 此 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 會開啟，且名為 Add-Ins 的 索引卷標會出現在功能區上。 按兩下 [載入宏] 索引標籤上的 [插入文字] 和 [插入資料表] 按鈕，以測試程序代碼。

測試 VSTO 增益集

  1. 按 F5 執行您的專案。

  2. 確認 功能區上會顯示 [載入宏] 索引 標籤。

  3. 按一下 [增益集] 索引標籤。

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

  5. 按兩下 [內容] 群組中的 [插入文字] 按鈕。

    這會在文件目前的游標位置上加入字串。

  6. 按兩下 [內容] 群組中的 [插入資料表] 按鈕。

    這會在文件目前的游標位置上加入表格。

下一步

您可以透過下列主題，進一步了解自訂 Office UI 的方式：

  • 自訂不同 Office 應用程式 數據列的功能區。 如需支援自定義功能區之應用程式的詳細資訊，請參閱 功能區概觀。

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

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

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

相關內容