將功能區設計工具的功能區匯出至功能區 XML

  • 發行項

功能區 (可視化設計工具) 項目不支援所有可能的功能區自訂類型。 若要以進階方式自訂功能區，您可以將功能區從設計工具匯出至功能區 XML，並直接編輯 XML。

注意

並非所有屬性值都會出現在功能區 XML 檔案中。 如需詳細資訊，請參閱功能區概觀。

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

若要將功能區設計工具的功能區匯出至功能區 XML

  1. 在方案總管中，以滑鼠右鍵按一下功能區程式碼檔案，然後按一下 [檢視設計工具]。

  2. 以滑鼠右鍵按一下功能區設計工具，然後按一下 [將功能區匯出至 XML]。

    Visual Studio 會將功能區 XML 檔案和功能區 XML 程式碼檔新增至您的專案。

  3. 在功能區程式碼類別中，找出開頭為 TODO: 的註解。

  4. 根據您正在開發的方案類型，將這些註解中的程式碼區塊複製到 ThisAddin、ThisWorkbook 或 ThisDocument 類別。

    此程式碼可讓 Microsoft Office 應用程式探索及載入您的自訂功能區。 如需詳細資訊，請參閱 Ribbon XML。

  5. 在 ThisAddin、ThisWorkbook 或 ThisDocument 類別中，取消註解程式碼區塊。

    取消註解程式碼後，它應類似於以下範例。 在此範例中，功能區類別稱為 MyRibbon。

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

  6. 切換至功能區 XML 程式碼檔案並尋找 Ribbon Callbacks 區域。

    您可以在此處撰寫回呼方法來處理 使用者動作，例如：按一下按鈕。

  7. 為您在功能區設計工具程式碼中撰寫的每個事件處理常式建立一個回呼方法。

  8. 將所有事件處理常式程式碼從事件處理常式移至回呼方法，並修改程式碼以使用功能區擴充功能 (RibbonX) 程式設計模型。

    如需撰寫回呼方法及使用 RibbonX 程式設計模型的相關資訊，請參閱功能區 XML。

相關內容