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 方法，並傳回您想要顯示的功能區。 此範例會要求您將兩個功能區新增至名為 Ribbon1 的專案，並使用Ribbon2功能區 (Visual Designer) 專案。 此範例會檢查名為 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) 專案。 如需詳細資訊，請參閱 功能區概觀。

您必須覆寫 或 RequestService 方法，CreateRibbonExtensibilityObject以傳回您使用功能區 (XML) 項目範本新增之專案中的功能區。 如需如何覆寫 CreateRibbonExtensibilityObject 方法的詳細資訊，請參閱 功能區 XML。