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 オブジェクトを返します。詳細については、「リボンの概要」を参照してください。
リボン (XML) 項目テンプレートを使用してプロジェクトに追加したリボンを返す場合は、CreateRibbonExtensibilityObject メソッドまたは RequestService メソッドをオーバーライドする必要があります。CreateRibbonExtensibilityObject メソッドのオーバーライド方法の詳細については、「リボン XML」を参照してください。
例
次のコード例では、プロジェクトの ThisAddin クラスまたは ThisDocument クラスにある CreateRibbonExtensibilityObject メソッドをオーバーライドして、表示するリボンを返します。この例では、リボン (ビジュアル デザイナー) 項目を使用して 2 つのリボン (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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。