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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。