共用方式為


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 安全性

請參閱

參考

DocumentBase 類別

Microsoft.Office.Tools.Word 命名空間