在執行階段存取功能區

更新：2007 年 11 月

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

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

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

使用 Globals 類別存取功能區

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

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

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

Private Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub

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

存取 Outlook 中的功能區集合

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

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

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub

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

請參閱

工作

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

逐步解說：在執行階段更新功能區中的控制項

概念

功能區概觀

功能區設計工具

功能區 XML

功能區物件模型概觀

自訂 Outlook 的功能區

在執行階段存取表單區域