리본 개체 모델 개요

Visual Studio Tools for Office 런타임은 런타임에 리본 컨트롤의 속성을 가져와서 설정하는 데 사용할 수 있는 강력한 형식의 개체 모델을 노출합니다. 예를 들어 메뉴 컨트롤을 동적으로 채웁니다. 또는 컨트롤을 상황에 따라 표시하고 숨길 수 있습니다. 리본 메뉴에 탭, 그룹 및 컨트롤을 추가할 수도 있지만 Office 응용 프로그램에서 리본을 로드하기 전에만 추가할 수 있습니다. 자세한 내용은 읽기 전용이 되는 속성 설정을 참조하세요.

적용 대상: 이 항목의 정보는 다음 애플리케이션에 대한 문서 수준 프로젝트 및 VSTO 추가 기능 프로젝트에 적용됩니다. Excel; InfoPath 2013 및 InfoPath 2010; Outlook; PowerPoint; 프로젝트; Visio; 단어. 자세한 내용은 Office 응용 프로그램 및 프로젝트 유형에서 사용할 수 있는 기능을 참조하세요.

이 리본 개체 모델은 주로 Ribbon 클래스, 리본 이벤트 및 리본 컨트롤 클래스로 구성됩니다.

리본 클래스

프로젝트에 새 리본(Visual Designer) 항목을 추가하면 Visual Studio에서는 리본 클래스를 프로젝트에 추가합니다. Ribbon 클래스는 RibbonBase 클래스를 상속합니다.

이 클래스는 리본 코드 파일과 리본 디자이너 코드 파일 간에 분할되는 부분 클래스로 나타납니다.

리본 이벤트

Ribbon 클래스에는 다음 세 가지 이벤트가 포함됩니다.

리본 컨트롤

네임스페이스에는 Microsoft.Office.Tools.Ribbon도구 상자의 Office 리본 컨트롤 그룹에 표시되는 각 컨트롤에 대한 형식이 포함됩니다.

다음 표에는 각 Ribbon 컨트롤의 형식이 표시됩니다. 각 컨트롤에 대한 설명은 리본 개요를 참조하세요.

네임스페이스 Microsoft.Office.Tools.Ribbon는 이러한 타입에 대해 "리본" 접두사를 사용하여 System.Windows.Forms 네임스페이스의 컨트롤 클래스 이름과 이름이 충돌하지 않도록 합니다.

리본 디자이너에 컨트롤을 추가하면 리본 디자이너에서 해당 컨트롤의 클래스를 리본 디자이너 코드 파일의 필드로 선언합니다.

리본 컨트롤의 속성을 사용하는 일반적인 작업

각 Ribbon 컨트롤에는 컨트롤에 레이블을 할당하거나 컨트롤을 숨기고 표시하는 등 다양한 작업을 수행하는 데 사용할 수 있는 속성이 포함되어 있습니다.

경우에 따라 리본 메뉴가 로드되거나 컨트롤이 동적 메뉴에 추가된 후 속성이 읽기 전용이 됩니다. 자세한 내용은 읽기 전용이 되는 속성 설정을 참조하세요.

다음 표에서는 컨트롤 속성을 사용하여 Ribbon 수행할 수 있는 몇 가지 작업에 대해 설명합니다.

읽기 전용이 되는 속성 설정

일부 속성은 리본이 로드되기 전에만 설정할 수 있습니다. 이러한 속성을 설정할 수 있는 3개의 위치는 다음과 같습니다.

• Visual Studio 속성 창에서

• Ribbon 클래스의 생성자에서

• CreateRibbonExtensibilityObject 프로젝트의 ThisAddin, ThisWorkbook, 또는 ThisDocument 클래스의 메서드에서

  동적 메뉴는 몇 가지 예외를 제공합니다. 메뉴가 포함된 리본 메뉴가 로드된 후에도 새 컨트롤을 만들고 해당 속성을 설정한 다음 런타임에 동적 메뉴에 추가할 수 있습니다.

  동적 메뉴에 추가하는 컨트롤의 속성은 언제든지 설정할 수 있습니다.

  자세한 내용은 읽기 전용이 되는 속성을 참조하세요.

리본의 생성자에서 속성 설정

Ribbon 클래스의 생성자에서 컨트롤의 속성을 설정할 수 있습니다. 이 코드는 메서드를 호출 InitializeComponent 한 후에 표시되어야 합니다. 다음은 현재 시간이 태평양 표준시(UTC-8) 17:00 또는 이후인 경우 그룹에 새 단추를 추가하는 예제입니다.

다음 코드를 추가합니다.

public Ribbon1()
    : base(Globals.Factory.GetRibbonFactory())
{
    InitializeComponent();
    if (System.DateTime.Now.Hour > 16)
    {
        Microsoft.Office.Tools.Ribbon.RibbonButton button =
            this.Factory.CreateRibbonButton();
        button.Label = "New Button";
        group1.Items.Add(button);
    }
}

<System.Diagnostics.DebuggerNonUserCode()> _
Public Sub New()
    MyBase.New(Globals.Factory.GetRibbonFactory())

    'This call is required by the Component Designer.
    InitializeComponent()
    Dim MyButton As Microsoft.Office.Tools.Ribbon.RibbonButton = _
        Me.Factory.CreateRibbonButton()
    MyButton.Label = "New Button"
    If System.DateTime.Now.Hour > 16 Then
        Group1.Items.Add(MyButton)
    End If

End Sub

Visual Studio 2008에서 업그레이드한 Visual C# 프로젝트에서 생성자가 리본 코드 파일에 나타납니다.

Visual Basic 프로젝트 또는 Visual Studio 2013에서 만든 Visual C# 프로젝트에서 생성자가 리본 디자이너 코드 파일에 나타납니다. 이 파일의 이름은 YourRibbonItem입니다. Designer.cs 또는 YourRibbonItem. Designer.vb. Visual Basic 프로젝트에서 이 파일을 보려면 먼저 솔루션 탐색기에서 모든 파일 표시 단추를 클릭해야 합니다.

CreateRibbonExtensibilityObject 메서드의 속성 설정

프로젝트의 ThisAddin, ThisWorkbook, 또는 ThisDocument 클래스에서 CreateRibbonExtensibilityObject 메서드를 재정의할 때 Ribbon 컨트롤의 속성을 설정할 수 있습니다. 메서드에 대한 자세한 내용은 CreateRibbonExtensibilityObject를 참조하세요.

다음은 Excel 통합 문서 프로젝트의 클래스 메서드 CreateRibbonExtensibilityObject 에서 ThisWorkbook 리본 속성을 설정하는 예제입니다.

다음 코드를 추가합니다.

protected override Microsoft.Office.Core.IRibbonExtensibility
    CreateRibbonExtensibilityObject()
{
    bool myCondition = false;
    if (myCondition == true)
    {
        Ribbon1 tempRibbon = new Ribbon1();
        tempRibbon.tab1.ControlId.ControlIdType =
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office;
        tempRibbon.tab1.ControlId.OfficeId = "TabHome";
        return Globals.Factory.GetRibbonFactory().CreateRibbonManager( 
            new Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
             { tempRibbon });
    }
    else
    {
        Ribbon2 tempRibbon = new Ribbon2();
        tempRibbon.tab1.ControlId.ControlIdType =
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office;
        tempRibbon.tab1.ControlId.OfficeId = "TabInsert";
        return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                            new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { tempRibbon });
    }
}

Protected Overrides Function CreateRibbonExtensibilityObject() _
    As Microsoft.Office.Core.IRibbonExtensibility
    Dim myCondition As Boolean = True
    If myCondition = True Then
        Dim tempRibbon As New Ribbon1()
        tempRibbon.Tab1.ControlId.ControlIdType = _
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office
        tempRibbon.Tab1.ControlId.OfficeId = "TabHome"
        Return Globals.Factory.GetRibbonFactory.CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() {tempRibbon})
    Else
        Dim tempRibbon As New Ribbon2()
        tempRibbon.Tab1.ControlId.ControlIdType = _
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office
        tempRibbon.Tab1.ControlId.OfficeId = "TabInsert"
        Return Globals.Factory.GetRibbonFactory.CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() {tempRibbon})
    End If
End Function

읽기 전용이 되는 속성

다음 표에서는 리본이 로드되기 전에만 설정할 수 있는 속성을 보여 줍니다.

Outlook 검사기에서 표시되는 리본 메뉴의 속성 설정

리본 메뉴가 포함된 인스펙터를 열 때마다 리본의 새 인스턴스가 만들어집니다. 그러나 리본의 첫 번째 인스턴스를 만들기 전에 위의 표에 나열된 속성을 설정할 수 있습니다. 첫 번째 인스턴스를 만든 후 첫 번째 인스턴스는 Outlook에서 리본을 로드하는 데 사용하는 XML 파일을 정의하기 때문에 이러한 속성은 읽기 전용이 됩니다.

리본 메뉴의 다른 인스턴스를 만들 때 이러한 속성을 다른 값으로 설정하는 조건부 논리가 있는 경우 이 코드는 아무런 영향을 주지 않습니다.

리본 컨트롤 이벤트

각 컨트롤 클래스에는 하나 이상의 이벤트가 포함됩니다. 다음 표에서는 이러한 이벤트를 설명합니다.

이러한 이벤트에 대한 이벤트 처리기에는 다음 두 개의 매개 변수가 있습니다.

관련 콘텐츠

• 런타임에 리본에 액세스
• 리본 개요
• 방법: 리본 사용자 지정 시작
• 리본 디자이너
• 연습: 리본 디자이너를 사용하여 사용자 지정 탭 만들기
• 연습 살펴보기: 런타임에 리본 메뉴의 컨트롤 업데이트
• Outlook에 대한 리본 메뉴 사용자 지정
• 방법: 기본 제공 탭 사용자 지정
• 방법: Backstage 보기에 컨트롤 추가
• 방법: 리본 디자이너에서 리본 XML로 리본 내보내기
• 방법: 추가 기능 사용자 인터페이스 오류 표시