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.IRibbonExtensibilityProtected Overridable Function CreateRibbonExtensibilityObject () As IRibbonExtensibility戻り値
Microsoft.Office.Core.IRibbonExtensibility インターフェイスを実装するオブジェクト。
例
次のコード例では、プロジェクトの CreateRibbonExtensibilityObject または ThisDocument クラスの ThisAddin メソッドをオーバーライドし、表示するリボンを返します。 この例では、リボン (Visual Designer) 項目を使用して、 というRibbon2名前Ribbon1のプロジェクトに 2 つのリボンを追加する必要があります。 この例では、 という名前 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) 項目テンプレートを使用してプロジェクトに追加したリボンを返すには、このメソッドをオーバーライドする必要はありません。 既定では、このメソッドはプロジェクト内のすべてのリボン (Visual Designer) 項目を表す オブジェクトを返RibbonManagerします。 詳細については、「リボンの 概要」を参照してください。
リボン (XML) 項目テンプレートをCreateRibbonExtensibilityObject使用して追加するプロジェクトでリボンを返すには、 メソッドまたは RequestService メソッドをオーバーライドする必要があります。 メソッドをオーバーライド CreateRibbonExtensibilityObject する方法の詳細については、「 リボン XML」を参照してください。