在运行时访问功能区

可编辑代码以显示、隐藏和修改功能区以及使用户能够从自定义任务窗格、操作窗格或 Outlook 窗体区域中的控件运行代码。

可以通过使用 Globals 类来访问功能区。 对于 Outlook 项目,可以访问在特定 Outlook 检查器或 Outlook 资源管理器窗口中显示的功能区。

适用于: 本主题中的信息适用于以下应用程序的文档级项目和 VSTO 外接程序项目: Excel;InfoPath 2013 和 InfoPath 2010;前景;幻灯片;项目;Visio;词。 有关详细信息,请参阅办公室应用程序和项目类型提供的功能。

使用 Globals 类访问功能区

可以使用 Globals 类从项目中的任何位置访问文档级项目或 VSTO 外接程序项目中的功能区。

有关该Globals类的详细信息,请参阅对办公室项目中对象的全局访问。

下面的示例使用 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";
}