逐步解說：使用功能區設計工具建立自定義索引標籤

  • 發行項

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

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

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

注意

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

必要條件

您需要下列元件才能完成這個逐步解說：

建立 Excel 活頁簿專案

所有 Office 應用程式使用功能區設計工具的步驟大部分相同。 這個範例會使用 Excel 活頁簿。

建立 Excel 活頁簿專案

  • 建立名稱為 MyExcelRibbon 的 Excel 活頁簿專案。 如需詳細資訊，請參閱 How to: Create Office Projects in Visual Studio。

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

建立動作窗格

將兩個自訂的執行窗格加入至專案。 您稍後會將兩個用來顯示和隱藏這些執行窗格的按鈕加入至自訂索引標籤。

建立執行窗格

  1. 在 [ 專案 ] 功能表中，選擇 [ 加入新項目]。

  2. 在 [ 新增專案 ] 對話框中，選取 [ActionsPaneControl]，然後選擇 [ 新增]。

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

  3. 從 [工具箱] 的 [通用控件] 索引標籤，將標籤新增至設計工具介面。

  4. 在 [屬性] 視窗中，將 label1 的 Text 屬性設定為 [動作窗格 1]。

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

建立自定義索引標籤

其中一個 Office 應用程式設計方針是使用者應一律具有 Office 應用程式 UI 的控制項。 若要為執行窗格加入這個功能，您可以加入顯示和隱藏功能區上自訂索引標籤的每個執行窗格的按鈕。 若要建立自定義索引標籤，請將功能區 （Visual Designer） 專案新增至專案。 設計工具可協助您加入及定位控制項、設定控制項屬性及處理控制項事件。

建立自訂索引標籤

  1. 在 [ 專案 ] 功能表中，選擇 [ 加入新項目]。

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

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

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

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

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

  6. 將 [ 標籤 ] 屬性設定為 [我的自定義] 索引標籤。

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

  8. 在 [屬性] 視窗中，將 [卷標] 設定為 [動作窗格管理員]。

  9. 從 [工具箱] 的 [Office 功能區控件] 索引卷標，將按鈕拖曳到 group1。

  10. 選取 button1。

  11. 在 [屬性] 視窗中，將 [卷標] 設定為 [顯示動作窗格 1]。

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

  13. 從 [工具箱] 的 [Office 功能區控件] 索引卷標，將 ToggleButton 控件拖曳到 group1。

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

使用自定義索引標籤上的按鈕隱藏和顯示執行窗格

最後一個步驟是加入回應使用者的程式碼。 針對兩個按鈕的 Click 事件和切換按鈕的 Click 事件加入事件處理常式。 將程式碼加入至這些事件處理常式以啟用隱藏和顯示執行窗格。

使用自訂索引標籤中的按鈕隱藏和顯示執行窗格

  1. 在 方案總管 中，開啟 MyRibbon.cs 或 MyRibbon.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. 選擇 [ 我的自定義索引標籤] 索引標籤 。

  3. 在 [ 自定義動作窗格管理員] 群組中，選擇 [ 顯示動作窗格 1]。

    執行窗格隨即出現，並顯示 [動作窗格 1] 標籤。

  4. 選擇 [ 顯示動作] 窗格 2。

    執行窗格隨即出現，並顯示 [動作窗格 2] 標籤。

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

    執行窗格將不再顯示。

下一步

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

相關內容