RibbonFactory.CreateRibbonManager 方法
创建一个 IRibbonExtensibility 对象,该对象表示一个功能区自定义项。
命名空间: Microsoft.Office.Tools.Ribbon
程序集: Microsoft.Office.Tools.Common(在 Microsoft.Office.Tools.Common.dll 中)
语法
声明
Function CreateRibbonManager ( _
ribbons As IRibbonExtension() _
) As IRibbonExtensibility
IRibbonExtensibility CreateRibbonManager(
IRibbonExtension[] ribbons
)
参数
- ribbons
类型:array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
一个 IRibbonExtension 实例数组。
返回值
类型:Microsoft.Office.Core.IRibbonExtensibility
一个表示功能区自定义项的对象。
备注
返回项目的 ThisAddin、ThisWorkbook 或 ThisDocument 类的 CreateRibbonExtensibilityObject 方法中的 IRibbonExtensibility 对象,以返回您希望在 Office 应用程序中显示的功能区。
示例
下面的示例使用一个条件来确定要显示哪些自定义功能区。此示例然后使用 CreateRibbonManager 方法创建并返回表示自定义功能区的 IRibbonExtension 对象。
说明 |
---|
此示例中使用的语法返回使用“功能区(可视化设计器)”项创建的功能区。用于返回使用“功能区(XML)”项创建的功能区的语法稍有不同。有关返回“功能区(XML)”项的更多信息,请参见功能区 XML。 |
Protected Overrides Function CreateRibbonExtensibilityObject() As _
Microsoft.Office.Core.IRibbonExtensibility
If myCondition = True Then
Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
(New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
{New Ribbon1()})
Else
Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
(New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
{New Ribbon2()})
End If
End Function
protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
{
if (myCondition == true)
{
return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
}
else
{
return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
}
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。