語言

操作指南:使用功能區設計工具建立自訂索引標籤

透過使用功能區設計工具,您可以建立自訂索引標籤,然後在其上新增和放置控制項。

適用於: 本主題中的資訊適用於 Excel 的文件層級專案。 如需詳細資訊,請參閱 Office 應用程式和專案類型所提供的功能

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

備註

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

先決條件

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

建立 Excel 活頁簿專案

對於所有 Office 應用程式,使用功能區設計工具的步驟幾乎相同。 這個範例會使用 Excel 活頁簿。

要創建一個 Excel 活頁簿專案

  • 建立名稱為 MyExcelRibbon 的 Excel 活頁簿專案。 如需詳細資訊,請參閱 如何:在 Visual Studio 中建立 Office 專案

    Visual Studio 會在設計工具中開啟新的活頁簿,並將 MyExcelRibbon 專案新增至 [方案總管]。

建立動作窗格

將兩個自訂動作窗格新增至專案。 您稍後會將顯示和隱藏這些動作窗格的按鈕新增至自訂索引標籤。

建立動作窗格

  1. [專案] 功能表上,選擇 [新增項目]。

  2. 在 [ 新增專案 ] 對話方塊中,選取 [ActionsPaneControl],然後選擇 [新增]。

    ActionsPaneControl1.csActionsPaneControl1.vb檔案會在設計工具中開啟。

  3. [工具箱] 的 [通用控制項] 索引標籤中,將標籤新增至設計工具介面。

  4. [屬性] 視窗中,將 label1 的 [文字] 屬性設定為 [動作窗格 1]。

  5. 重複步驟 1 到 5 以建立第二個動作窗格和標籤。 將第二個標籤的 [文字] 屬性設定為 [動作窗格 2]。

建立自訂索引標籤

其中一個 Office 應用程式設計指導方針是使用者應該一律控制 Office 應用程式 UI。 若要為動作窗格新增此功能,您可以新增按鈕,從功能區上的自訂索引標籤中顯示和隱藏每個動作窗格。 若要建立自訂索引標籤,請將 功能區 (視覺化設計工具) 項目新增至專案。 設計工具可協助您新增和定位控制項、設定控制項屬性,以及處理控制項事件。

建立自訂索引標籤

  1. [專案] 功能表上,選擇 [新增項目]。

  2. 在 [新增項目] 對話方塊中,選取 [功能區(視覺化設計工具)]。

  3. 將新功能區的名稱變更為 MyRibbon,然後選擇 [新增]。

    MyRibbon.csMyRibbon.vb檔案會在功能區設計工具中開啟,並顯示預設索引標籤和群組。

  4. 在功能區設計工具中,選擇預設索引標籤。

  5. [屬性] 視窗中,展開 ControlId 屬性,然後將 ControlIdType 屬性設定為 Custom

  6. 標籤 屬性設定為 我的自訂索引標籤

  7. 在功能區設計工具中,選擇 group1

  8. 「內容」 視窗中,將 「標籤」 設定為 「動作窗格管理員」。

  9. [工具箱] 的 [Office 功能區控制項] 索引標籤中,將按鈕拖曳到 group1

  10. 選取 按鈕1

  11. 「內容」 視窗中,將 「標籤」 設定為 「顯示動作窗格 1」。

  12. 將第二個按鈕新增至 group1,並將 [標籤] 屬性設定為 [顯示動作窗格 2]。

  13. [工具箱] 的 [Office 功能區控制項] 索引標籤中,將 ToggleButton 控制項拖曳到 group1

  14. [標籤 ] 屬性設定為 [隱藏動作窗格]。

使用自訂索引標籤上的按鈕隱藏和顯示動作窗格

最後一步是添加響應用戶的代碼。 新增兩個按鈕的Click事件處理常式以及切換按鈕的Click事件處理常式。 將程式碼新增至這些事件處理常式,以啟用隱藏和顯示動作窗格。

要使用自訂索引標籤中的按鈕來隱藏和顯示動作窗格

  1. [方案總管] 中,開啟 MyRibbon.csMyRibbon.vb 的捷徑功能表,然後選擇 [ 檢視程式碼]。

  2. 將下列程式碼新增至 MyRibbon 類別的開頭。 此程式碼會建立兩個動作窗格物件。

    ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
    ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();
    
  3. MyRibbon_Load 方法用下列程式碼取代。 此程式碼會將動作窗格物件新增至 Controls 集合中,並從檢視中隱藏這些物件。 Visual C# 程式碼也會將委派處理方法附加到數個功能區控制項事件。

    private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
    {
        Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
        Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
        actionsPane1.Hide();
        actionsPane2.Hide();
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
    
        this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
            this.button1_Click);
        this.button2.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
            this.button2_Click);
        this.toggleButton1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
            this.toggleButton1_Click);
    
    
    }
    
  4. 將下列三個事件處理常式方法 MyRibbon 新增至類別。 這些方法會處理 Click 兩個按鈕的事件,以及 Click 切換按鈕的事件。 button1 和 button2 的事件處理常式會顯示替代動作窗格。 toggleButton1 的事件處理常式會顯示和隱藏作用中動作窗格。

    private void button1_Click(object sender, RibbonControlEventArgs e)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
        actionsPane2.Hide();
        actionsPane1.Show();
        toggleButton1.Checked = false;
    }
    
    private void button2_Click(object sender, RibbonControlEventArgs e)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
        actionsPane1.Hide();
        actionsPane2.Show();
        toggleButton1.Checked = false;
    
    }
    
    private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
    {
        if (toggleButton1.Checked == true)
        {
            Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
        }
        else
        {
            Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
        }
    
    }
    

測試自訂索引標籤

當您執行專案時,Excel 會啟動,功能區上會出現 [我的自訂索引標籤 ]。 選擇 [我的自訂索引標籤 ] 上的按鈕,以顯示和隱藏動作窗格。

測試自訂索引標籤

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

  2. 選擇 My Custom Tab (我的自訂索引標籤 ) 索引標籤。

  3. [自訂動作窗格管理員] 群組中,選擇 [顯示動作窗格 1]。

    動作窗格隨即出現,並顯示標籤 動作窗格 1

  4. 選擇 Show Actions Pane 2 (顯示動作窗格 2)。

    動作窗格隨即出現,並顯示標籤 動作窗格 2

  5. 選擇 [隱藏動作窗格]。

    動作窗格不再可見。

後續步驟

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