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 인터페이스를 구현하는 개체입니다.

예제

다음 코드 예제는 프로젝트의 또는 ThisDocument 클래스에서 메서드를 ThisAddin 재정 CreateRibbonExtensibilityObject 의하고 표시할 리본을 반환합니다. 이 예제에서는 리본 메뉴(Visual Designer) 항목을 사용하여 라는 Ribbon1Ribbon2 두 개의 리본을 프로젝트에 추가해야 합니다. 이 예제에서는 라는 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) 항목 템플릿을 사용하여 추가한 프로젝트의 리본을 반환하려면 또는 RequestService 메서드를 재정 CreateRibbonExtensibilityObject 의해야 합니다. 메서드를 재정의하는 방법에 대한 자세한 내용은 리본 XML을 CreateRibbonExtensibilityObject 참조하세요.