DocumentBase.CreateRibbonExtensibilityObject 方法
返回实现 Microsoft.Office.Core.IRibbonExtensibility 接口的对象。
命名空间： Microsoft.Office.Tools.Word
程序集： Microsoft.Office.Tools.Word.v4.0.Utilities（在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中）
语法
声明
Protected Overridable Function CreateRibbonExtensibilityObject As IRibbonExtensibility
protected virtual IRibbonExtensibility CreateRibbonExtensibilityObject()
返回值
类型：Microsoft.Office.Core.IRibbonExtensibility
一个实现 Microsoft.Office.Core.IRibbonExtensibility 接口的对象。
备注
重写此方法可返回 Microsoft.Office.Core.IRibbonExtensibility 接口的一个实现。 如果项目中有多个功能区，则可以指定要在运行时显示的功能区。
不必重写此方法即可返回使用**“功能区(可视化设计器)”项模板添加到项目中的功能区。 默认情况下，此方法返回一个 RibbonManager 对象，该对象表示项目中的所有“功能区(可视化设计器)”**项。 有关更多信息，请参见 功能区概述。
必须重写 CreateRibbonExtensibilityObject 或 RequestService 方法，才能返回使用**“功能区(XML)”**项模板添加到项目中的功能区。 有关如何重写 CreateRibbonExtensibilityObject 方法的更多信息，请参见功能区 XML。
示例
下面的代码示例将重写项目的 ThisAddin 或 ThisDocument 类中的 CreateRibbonExtensibilityObject 方法，并返回要显示的功能区。 该示例要求使用**“功能区(可视化设计器)”**项在项目中添加两个功能区：Ribbon1 和 Ribbon2。 该示例将检查名为 myCondition 的字段的值，并返回相应的功能区。 若要使用此示例，请从文档级项目内的 ThisDocument 类中运行此示例。
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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。