自訂 Outlook 的功能區

當您在 Microsoft Office Outlook 自訂功能區時,您必須考慮自訂功能區在應用程式中出現的位置。 Outlook 會將功能區顯示在主應用程式使用者介面 (UI) 中,以及在使用者執行建立電子郵件訊息等特定工作時開啟的視窗中。 這些應用程式視窗名為偵測器。

適用于: 本主題中的資訊適用于 Outlook 的 VSTO 新增 - 專案。 如需詳細資訊,請參閱 依 Office 應用程式和專案類型提供的功能

將自訂功能區新增至主應用程式 UI

Outlook 中的主應用程式 UI 稱為「總管」。 如果您使用 功能區 (的視覺化設計工具) 專案中,您可以在 [屬性] 視窗中按一下功能區的 [ RibbonType ] 屬性,然後選取 [Microsoft. Outlook,將功能區加入至 Explorer 。Explorer

將功能區指派給偵測器

您可藉由指定與偵測器訊息類別相對應的功能區類型,識別您想要自訂的偵測器。

如果您使用 功能區 (視覺化設計工具) 專案,請在 [屬性] 視窗中按一下功能區的 [ RibbonType ] 屬性,然後從值清單中選取一或多個功能區識別碼。

您可以在專案中加入多個功能區。 如果有多個功能區共用功能區 ID,請覆寫在專案 ThisAddin 類別中的 CreateRibbonExtensibilityObject 方法,以指定要在執行階段顯示哪個功能區。 如需詳細資訊,請參閱 功能區總覽。 如需每個功能區類型的詳細資訊,請參閱技術檔自訂 Outlook 2007 中的功能區

使用功能區 XML 來指定功能區類型

如果您使用 功能區 (XML) 專案,請檢查方法中 ribbonID 參數的值, GetCustomUI 並傳回適當的功能區。

GetCustomUI 方法會在功能區程式碼檔中由 Visual Studio 自動產生。 RibbonID 參數是用來識別 Explorer 或特定類型之偵測器的字串。 如需 ribbonID 參數可能值的完整清單,請參閱技術檔 自訂 Outlook 2007 中的功能區

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

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

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

    return ribbonXML;
}
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

另請參閱