DocumentBase.CreateRibbonExtensibilityObject 方法

定义

命名空间:

Microsoft.Office.Tools.Word

程序集:

Microsoft.Office.Tools.Word.v4.0.Utilities.dll

返回实现 Microsoft.Office.Core.IRibbonExtensibility 接口的对象。

protected:
 virtual Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonExtensibilityObject();

protected virtual Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject ();

abstract member CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
override this.CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility

Protected Overridable Function CreateRibbonExtensibilityObject () As IRibbonExtensibility

返回

IRibbonExtensibility

实现 Microsoft.Office.Core.IRibbonExtensibility 接口的对象。

示例

下面的代码示例重写CreateRibbonExtensibilityObject项目的 或 ThisDocument 类中的 ThisAddin 方法，并返回要显示的功能区。 该示例要求使用 Visual Designer) 项的功能区 ( 将两个功能区添加到名为 Ribbon1 和 Ribbon2 的项目。 该示例检查名为 myCondition 的字段的值，并返回相应的功能区。 若要使用此示例，请从文档级项目中的 ThisDocument 类运行它。

    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() });
        }
    }

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

注解

重写此方法以返回 接口的 Microsoft.Office.Core.IRibbonExtensibility 实现。 如果项目中有多个功能区，可以指定要在运行时显示的功能区。

无需重写此方法，以返回通过使用 Visual Designer) 项模板的功能区 ( 添加到项目的功能区。 默认情况下，此方法返回一个 RibbonManager 对象，该对象代表项目中的所有功能区 (Visual Designer) 项。 有关详细信息，请参阅 功能区概述。

必须重写 CreateRibbonExtensibilityObject 或 RequestService 方法，以返回项目中使用 功能区 (XML) 项模板添加的功能区。 有关如何重写 CreateRibbonExtensibilityObject 方法的详细信息，请参阅 Ribbon XML。