연습: 리본 디자이너를 사용하여 사용자 지정 탭 만들기

아티클
04/28/2010

업데이트: 2007년 11월

적용 대상
이 항목의 정보는 지정된 Visual Studio Tools for Office 프로젝트 및 Microsoft Office 버전에만 적용됩니다. 프로젝트 형식 문서 수준 프로젝트 응용 프로그램 수준 프로젝트 Microsoft Office 버전 Excel 2007 Word 2007 Outlook 2007 PowerPoint 2007 자세한 내용은 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.

이 항목의 정보는 지정된 Visual Studio Tools for Office 프로젝트 및 Microsoft Office 버전에만 적용됩니다.

프로젝트 형식

문서 수준 프로젝트
응용 프로그램 수준 프로젝트

Microsoft Office 버전

Excel 2007
Word 2007
Outlook 2007
PowerPoint 2007

자세한 내용은 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.

이 연습에서는 리본 디자이너를 사용하여 사용자 지정 리본 탭을 만드는 방법을 보여 줍니다. 리본 디자이너를 사용하여 사용자 지정 탭에 컨트롤을 추가하고 배치할 수 있습니다.

이 연습에서는 다음 작업을 수행합니다.

작업 창 만들기
사용자 지정 탭 만들기
사용자 지정 탭의 단추를 사용하여 작업 창 숨기기 및 표시

참고:
시스템에서 일부 Visual Studio 사용자 인터페이스 요소에 대해 다음 지침에서 설명한 것과 다른 이름 또는 위치를 표시할 수 있습니다. 설치한 Visual Studio 버전과 사용하는 설정에 따라 이러한 요소가 결정됩니다. 자세한 내용은 Visual Studio 설정을 참조하십시오.

사전 요구 사항

이 연습을 완료하려면 다음 구성 요소가 필요합니다.

Visual Studio Tools for Office(Visual Studio 2008 Professional 및 Visual Studio Team System의 선택적 구성 요소)
Microsoft Office Excel 2007

Visual Studio Tools for Office는 기본적으로 나열된 Visual Studio 버전과 함께 설치됩니다. 설치 여부를 확인하려면 Visual Studio Tools for Office 설치를 참조하십시오.

비디오 데모를 보려면 Video How to: Creating a Custom Tab by Using the Ribbon Designer를 참조하십시오.

Excel 통합 문서 프로젝트 만들기

리본 디자이너를 사용하는 단계는 모든 Office 응용 프로그램에서 거의 동일합니다. 이 예제에서는 Excel 통합 문서를 사용합니다.

Excel 통합 문서 프로젝트를 만들려면

MyExcelRibbon이라는 Excel 2007 통합 문서 프로젝트를 만듭니다. 자세한 내용은 방법: Visual Studio Tools for Office 프로젝트 만들기를 참조하십시오.

Visual Studio의 디자이너에 새 통합 문서가 열리고 MyExcelRibbon 프로젝트가 솔루션 탐색기에 추가됩니다.

작업 창 만들기

프로젝트에 두 개의 사용자 지정 작업 창을 추가합니다. 나중에 이러한 작업 창을 표시하거나 숨기는 단추를 사용자 지정 탭에 추가합니다.

작업 창을 만들려면

프로젝트 메뉴에서 새 항목 추가를 클릭합니다.
새 항목 추가 대화 상자에서 ActionsPaneControl을 선택한 다음 추가를 클릭합니다.

ActionsPaneControl1.cs 또는 ActionsPaneControl1.vb 파일이 디자이너에서 열립니다.
도구 상자의 공용 컨트롤 탭에서 디자이너 화면에 레이블을 추가합니다.
속성 창에서 label1의 Text 속성을 Actions Pane 1로 설정합니다.
1-5단계를 반복하여 두 번째 작업 창 및 레이블을 만듭니다. 두 번째 레이블의 Text 속성을 Actions Pane 2로 설정합니다.

사용자 지정 탭 만들기

Office 응용 프로그램의 디자인 지침 중 하나는 사용자가 항상 Office 응용 프로그램 UI를 제어할 수 있어야 한다는 것입니다. 작업 창에 대해 이 기능을 추가하려면 리본 메뉴의 사용자 지정 탭에서 각 작업 창을 표시하거나 숨기는 단추를 추가합니다. 사용자 지정 탭을 만들려면 프로젝트에 리본(비주얼 디자이너) 항목을 추가합니다. 이 디자이너는 컨트롤을 추가 및 배치하고, 컨트롤 속성을 설정하고, 컨트롤 이벤트를 처리하는 데 유용합니다.

사용자 지정 탭을 만들려면

프로젝트 메뉴에서 새 항목 추가를 클릭합니다.
새 항목 추가 대화 상자에서 **리본(비주얼 디자이너)**을 선택합니다.
새 리본 메뉴의 이름을 MyRibbon으로 변경하고 추가를 클릭합니다.

MyRibbon.cs 또는 MyRibbon.vb 파일이 리본 디자이너에서 열리고 기본 탭 및 그룹이 표시됩니다.
리본 디자이너에서 group1을 클릭합니다.
속성 창에서 Label 속성을 Actions Pane Manager로 설정합니다.
도구 상자의 Office 리본 컨트롤 탭에 있는 단추를 group1로 끌어 옵니다.
button1을 클릭하여 선택합니다.
속성 창에서 Label을 Show Actions Pane 1로 설정합니다.
두 번째 단추를 group1에 추가하고 Label 속성을 Show Actions Pane 2로 설정합니다.
도구 상자의 Office 리본 컨트롤 탭에서 ToggleButton 컨트롤을 group1로 끌어 옵니다.
Label 속성을 Hide Actions Pane으로 설정합니다.

사용자 지정 탭의 단추를 사용하여 작업 창 숨기기 및 표시

마지막 단계는 사용자에게 응답하는 코드를 추가하는 것입니다. 두 단추의 Click 이벤트와 설정/해제 단추의 Click 이벤트에 대한 이벤트 처리기를 추가합니다. 이러한 이벤트 처리기에 작업 창을 숨기거나 표시하는 코드를 추가합니다.

사용자 지정 탭의 단추를 사용하여 작업 창을 숨기거나 표시하려면

솔루션 탐색기에서 MyRibbon.cs 또는 MyRibbon.vb를 마우스 오른쪽 단추로 클릭한 다음 코드 보기를 클릭합니다.

다음 코드를 MyRibbon 클래스의 맨 위에 추가합니다. 이 코드는 두 개의 작업 창 개체를 만듭니다.

Dim actionsPane1 As New ActionsPaneControl1()
Dim actionsPane2 As New ActionsPaneControl2()

ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();

C#의 경우 생성자에 다음 이벤트 처리기를 추가해야 합니다. 이벤트 처리기를 만드는 방법에 대한 자세한 내용은 방법: Visual Studio Tools for Office에서 이벤트 처리기 만들기를 참조하십시오.

this.button1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button1_Click);
this.button2.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button2_Click);
this.toggleButton1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.toggleButton1_Click);
this.Load += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs>
        (this.MyRibbon_Load);

다음 코드를 MyRibbon_Load 이벤트에 추가합니다. 이 코드는 작업 창 Microsoft.Office.Tools.ActionsPane.Controls 컬렉션에 작업 창 개체를 추가하고 보기에서 해당 개체를 숨깁니다.

Private Sub MyRibbon_Load(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs) _
        Handles MyBase.Load

    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1)
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2)
    actionsPane1.Hide()
    actionsPane2.Hide()
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
End Sub

private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
{
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
    actionsPane1.Hide();
    actionsPane2.Hide();
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
}

MyRibbon 클래스에 다음 세 개의 이벤트 처리기 메서드를 추가합니다. 이러한 메서드는 두 단추의 Click 이벤트와 설정/해제 단추의 Click 이벤트를 처리합니다. button1 및 button2에 대한 이벤트 처리기는 대체 작업 창을 표시합니다. toggleButton1에 대한 이벤트 처리기는 활성 작업 창을 표시하거나 숨깁니다.

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles Button1.Click
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    actionsPane2.Hide()
    actionsPane1.Show()
End Sub

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles Button2.Click

    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    actionsPane1.Hide()
    actionsPane2.Show()

End Sub


Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles ToggleButton1.Click

    If ToggleButton1.Checked Then
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
    Else
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    End If

End Sub

private void button1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane2.Hide();
    actionsPane1.Show();
}

private void button2_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane1.Hide();
    actionsPane2.Show();

}

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    if (toggleButton1.Checked == true)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
    }
    else
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    }

}

사용자 지정 탭 테스트

프로젝트를 시작하면 Excel이 시작되고 리본 메뉴에 추가 기능 탭이 표시됩니다. 추가 기능의 단추를 클릭하여 작업 창을 표시하거나 숨깁니다.

사용자 지정 탭을 테스트하려면

F5 키를 눌러 프로젝트를 실행합니다.
추가 기능 탭을 클릭합니다.
Custom Actions Pane Manager 그룹에서 Show Actions Pane 1을 클릭합니다.

작업 창이 나타나고 Actions Pane 1이라는 레이블이 표시됩니다.
Show Actions Pane 2를 클릭합니다.

작업 창이 나타나고 Actions Pane 2라는 레이블이 표시됩니다.
Hide Actions Pane을 클릭합니다.

작업 창이 더 이상 표시되지 않습니다.