DocumentBase.CreateRibbonExtensibilityObject 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
傳回實作 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
傳回
實作 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。