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 메서드를 재정의하고 표시할 리본 메뉴를 반환합니다. 이 예제를 실행하려면 리본(비주얼 디자이너) 항목을 사용하여 프로젝트에 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 보안

• 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

DocumentBase 클래스

Microsoft.Office.Tools.Word 네임스페이스