自訂 Outlook 的功能區

更新：2007 年 11 月

適用於
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。 專案類型 應用程式層級專案 Microsoft Office 版本 Outlook 2007 如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

自訂 Microsoft Office Outlook 2007 的功能區時，您必須考慮自訂功能區出現在應用程式中的位置。Outlook 並不會將功能區顯示在主應用程式使用者介面 (UI) 中；而是將功能區顯示在使用者執行某些工作 (例如建立電子郵件訊息) 時所開啟的視窗中。我們將這些應用程式視窗稱為偵測器。

將功能區指派給偵測器

您可藉由指定對應偵測器訊息類型的功能區類型，來識別要自訂的偵測器。指定功能區類型的步驟是根據使用 [功能區設計工具] 或 [功能區 XML] 而定。

使用功能區設計工具

如果您使用 [功能區 (視覺化設計工具)] 項目，請按一下功能區 [屬性] 視窗中的 [RibbonType] 屬性，然後從值清單選取一個或多個功能區 ID。

您可以將多個功能區加入專案中。如果多個功能區共用一個功能區 ID，請覆寫專案的 ThisAddin 類別中的 CreateRibbonExtensibilityObject 方法，以指定要在執行階段顯示的功能區。

如需詳細資訊，請參閱功能區概觀。

如需每個功能區類型的詳細資訊，請參閱技術文件自訂 Outlook 2007 的功能區。

使用功能區 XML

如果您使用 [功能區 (XML)] 項目，請檢查 Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI 方法中 ribbonID 參數的值，並傳回適當的功能區。

Microsoft.Office.Core.IRibbonExtensibility.GetCustomUI 方法會由 Visual Studio Tools for Office 在功能區程式碼檔案中自動產生。ribbonID 參數是識別特定偵測器類型的字串。如需 ribbonID 參數可能值的完整清單，請參閱技術文件自訂 Outlook 2007 的功能區。

下列程式碼範例示範如何只在 Microsoft.Outlook.Mail.Compose 偵測器中顯示自訂功能區。這是在使用者新建電子郵件訊息時所開啟的偵測器。要顯示的功能區會在 GetResourceText() 方法中指定，而該方法會在功能區類別中產生。如需功能區類別的詳細資訊，請參閱功能區 XML。

Public Function GetCustomUI(ByVal ribbonID As String) As String _
    Implements Office.IRibbonExtensibility.GetCustomUI

    Dim ribbonXML As String = String.Empty

    If ribbonID = "Microsoft.Outlook.Mail.Compose" Then
        ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml")
    End If

    Return ribbonXML
End Function

public string GetCustomUI(string ribbonID)
{
    string ribbonXML = String.Empty;

    if (ribbonID == "Microsoft.Outlook.Mail.Compose")
    {
        ribbonXML = GetResourceText("Trin_RibbonOutlookBasic.Ribbon1.xml");
    }

    return ribbonXML;
}

請參閱

概念

在執行階段存取功能區

功能區概觀

功能區設計工具

功能區 XML