런타임에 리본 메뉴에 액세스Access the Ribbon at run time

리본을 표시, 숨기기 및 수정하고, 사용자가 사용자 지정 작업창, 작업 창 또는 Outlook 양식 영역의 컨트롤에서 코드를 실행할 수 있도록 하는 코드를 작성할 수 있습니다.You can write code to show, hide, and modify the Ribbon, and enable users to run the code from controls in a custom task pane, actions pane, or Outlook form region.

Globals 클래스를 사용하여 리본 메뉴에 액세스할 수 있습니다.You can access the Ribbon by using the Globals class. Outlook 프로젝트의 경우 특정 Outlook 검사기나 Outlook 탐색기 창에 나타나는 리본 메뉴에 액세스할 수 있습니다.For Outlook projects, you can access the Ribbons that appear in a specific Outlook Inspector or Outlook Explorer window.

적용 대상: 이 항목의 정보는 - 다음 응용 프로그램의 문서 수준 프로젝트 및 VSTO 추가 프로젝트에 적용 됩니다 - . Excel; InfoPath 2013 및 InfoPath 2010; 했습니다 보기가 프로젝트가 화면이 단어씩.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for the following applications: Excel; InfoPath 2013 and InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조 하세요.For more information, see Features available by Office application and project type.

Globals 클래스를 사용 하 여 리본 메뉴에 액세스Access the Ribbon by using the Globals class

Globals 클래스를 사용하여 프로젝트의 어디에서나 문서 수준 프로젝트 또는 VSTO 추가 기능 프로젝트의 리본 메뉴에 액세스할 수 있습니다.You can use the Globals class to access the Ribbon in a document-level project or VSTO Add-in project from anywhere in the project.

클래스에 대 한 자세한 내용은 Globals Office 프로젝트의 개체에 대 한 전역 액세스를 참조 하세요.For more information about the Globals class, see Global access to objects in Office projects.

다음 예제에서는 Globals 클래스를 사용하여 Ribbon1이라는 사용자 지정 리본 메뉴에 액세스하고 리본 메뉴의 콤보 상자에 표시되는 텍스트를 Hello World로 설정합니다.The following example uses the Globals class to access a custom Ribbon named Ribbon1 and set the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub
private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

특정 Outlook 검사기 창에 나타나는 리본 컬렉션에 액세스Access a collection of Ribbons that appear in a specific Outlook Inspector window

Outlook 검사기 에 나타나는 리본 컬렉션에 액세스할 수 있습니다.You can access a collection of Ribbons that appear in Outlook Inspectors. 검사기는 사용자가 메일 메시지 만들기 등의 특정 작업을 수행할 때 Outlook에서 열리는 창입니다.An Inspector is a window that opens in Outlook when users perform certain tasks, such as creating e-mail messages. 검사기 창의 리본 메뉴에 액세스하려면 Globals 클래스의 Ribbons 속성을 호출하고 검사기를 나타내는 Inspector 개체를 전달합니다.To access the Ribbon of an Inspector window, call the Ribbons property of the Globals class and pass in an Inspector object that represents the Inspector.

다음 예제에서는 현재 포커스가 있는 검사기의 리본 컬렉션을 가져옵니다.The following example gets the Ribbon collection of the Inspector that currently has focus. 이 예제에서는 Ribbon1이라는 리본 메뉴에 액세스하고 리본 메뉴의 콤보 상자에 표시되는 텍스트를 Hello World로 설정합니다.This example then accesses a Ribbon named Ribbon1 and sets the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

특정 Outlook 탐색기에 대해 표시 되는 리본 컬렉션 액세스Access a collection of Ribbons that appear for a specific Outlook Explorer

Outlook 탐색기 에 나타나는 리본 컬렉션에 액세스할 수 있습니다.You can access a collection of Ribbons that appear in an Outlook Explorer. 탐색기는 Outlook 인스턴스에 대한 기본 애플리케이션 UI(사용자 인터페이스)입니다.An Explorer is the main application user interface (UI) for an instance of Outlook. 탐색기 창의 리본 메뉴에 액세스하려면 Globals 클래스의 Ribbons 속성을 호출하고 탐색기를 나타내는 Explorer 개체를 전달합니다.To access the Ribbon of an Explorer window, call the Ribbons property of the Globals class and pass in an Explorer object that represents the Explorer.

다음 예제에서는 현재 포커스가 있는 탐색기의 리본 컬렉션을 가져옵니다.The following example gets the Ribbon collection of the Explorer that currently has focus. 이 예제에서는 Ribbon1이라는 리본 메뉴에 액세스하고 리본 메뉴의 콤보 상자에 표시되는 텍스트를 Hello World로 설정합니다.This example then accesses a Ribbon named Ribbon1 and sets the text that appears on a combo box on the Ribbon to Hello World.

Private Sub Access_Ribbons_By_Explorer()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

참고 항목See also