在執行階段存取功能區

  • 發行項

您可以撰寫程式碼以顯示、隱藏和修改功能區，並且讓使用者從自訂工作窗格、執行窗格或 Outlook 表單區域中的控制項執行程式碼。

您可以使用 Globals 類別來存取功能區。 針對 Outlook 專案，您可以存取出現在特定 [Outlook 檢查] 或 [Outlook 總管] 視窗中的功能區。

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

使用 Globals 類別來存取功能區

您可以使用 Globals 類別，從專案中任意位置存取文件層級專案或 VSTO 增益集專案中的功能區。

如需關於 Globals 類別的詳細資訊，請參閱全域存取 Office 專案中的物件。

以下範例將使用 Globals 類別存取名為 Ribbon1 的自訂功能區，並且將出現在功能區下拉式方塊中的文字設定為 Hello World。

private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

存取出現在特定 [Outlook 檢查] 視窗中的功能區集合

您可以存取 [Outlook 檢查] 中出現的功能區集合。 [檢查] 是一個視窗，會在使用者執行特定工作 (例如建立電子郵件訊息) 時，在 Outlook 中開啟。 若要存取 [檢查] 視窗的功能區，請呼叫 Globals 類別的 Ribbons 屬性，並傳入代表 [檢查] 的 Inspector 物件。

以下範例將取得目前擁有焦點之 [檢查] 中的功能區集合。 然後這個範例會存取名為 Ribbon1 的功能區，並且將出現在功能區上下拉式方塊中的文字設定為 Hello World。

private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

存取特定 [Outlook 總管] 視窗所顯示的功能區集合

您可以存取 [Outlook 總管] 中出現的功能區集合。 [總管] 是 Outlook 執行個體的主要應用程式使用者介面 (UI)。 若要存取 [總管] 視窗的功能區，請呼叫 Globals 類別的 Ribbons 屬性，並傳入代表 [總管] 的 Explorer 物件。

下列範例會取得目前擁有焦點的 [總管] 中的功能區集合。 然後這個範例會存取名為 Ribbon1 的功能區，並且將出現在功能區上下拉式方塊中的文字設定為 Hello World。

private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

相關內容