RibbonMenu 클래스(2007 시스템)

아티클
08/22/2008

업데이트: 2007년 11월

리본 메뉴 탭 또는 Microsoft Office 메뉴의 메뉴를 나타냅니다.

네임스페이스: Microsoft.Office.Tools.Ribbon
어셈블리: Microsoft.Office.Tools.Common.v9.0(Microsoft.Office.Tools.Common.v9.0.dll)

구문

<ToolboxBitmapAttribute(GetType(RibbonMenu), "RibbonMenu.bmp")> _
Public NotInheritable Class RibbonMenu _
    Inherits RibbonControl

Dim instance As RibbonMenu

[ToolboxBitmapAttribute(typeof(RibbonMenu), "RibbonMenu.bmp")]
public sealed class RibbonMenu : RibbonControl

설명

도구 상자의 Office 리본 컨트롤 탭에서 Menu 컨트롤을 리본 디자이너로 끌어 오면 Visual Studio Tools for Office에서는 RibbonMenu 클래스의 인스턴스를 만듭니다.

일반 작업

다음 표에서는 일반적인 작업에 유용한 멤버를 보여 줍니다. 이러한 모든 작업은 디자인 타임에 수행할 수 있습니다. 이러한 작업 중 일부는 런타임에 Office 응용 프로그램에 리본 메뉴가 로드되기 전 또는 동적 메뉴에 컨트롤이 추가되기 전에만 수행할 수 있습니다. 자세한 내용은 리본 개체 모델 개요를 참조하십시오.

작업	멤버
메뉴에 이미지를 표시합니다.	Image 또는 ImageName 속성을 사용합니다. 기본 제공 리본 컨트롤에 나타나는 이미지를 다시 사용할 수도 있습니다. 이렇게 하려면 OfficeImageId를 메뉴의 아이콘으로 표시할 기본 제공 Microsoft Office 이미지의 ID로 설정합니다.
메뉴의 크기를 변경합니다.	ControlSize 속성을 원하는 값으로 설정합니다. 예를 들어 큰 메뉴의 경우 해당 속성을 Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge로 설정합니다.
메뉴의 항목 크기를 변경합니다.	ItemSize 속성을 원하는 값으로 설정합니다. 예를 들어 큰 항목을 표시하려면 해당 속성을 Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge로 설정합니다.
런타임에 메뉴를 변경할 수 있도록 합니다. 예를 들어 런타임에 메뉴에 컨트롤을 추가할 수 있도록 합니다.	Dynamic 속성을 true로 설정합니다.
메뉴의 컨트롤에 액세스하거나, 메뉴에 컨트롤을 추가하거나, 메뉴에서 컨트롤을 제거합니다.	Items 속성을 사용합니다.
Microsoft Office 메뉴, 그룹 또는 메뉴를 포함할 수 있는 다른 컨트롤에 메뉴를 추가합니다.	RibbonMenu 생성자를 사용하여 RibbonMenu 클래스의 인스턴스를 만든 다음 Microsoft Office 메뉴, 그룹 또는 컨트롤의 Items 속성에 새 RibbonMenu를 추가합니다.

예제

다음 예제에서는 런타임에 기존 메뉴에 하위 메뉴를 추가하고 채우는 방법을 보여 줍니다.

런타임에 컨트롤을 업데이트하고 LINQ(Language-Integrated Query)를 사용하여 AdventureWorks 샘플 데이터베이스의 데이터를 가져오는 기능을 포함하는 보다 완전한 예제는 연습: 런타임에 리본 메뉴의 컨트롤 업데이트를 참조하십시오.

이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

리본(비주얼 디자이너) 항목을 Visual Studio Tools for Office 프로젝트에 추가합니다.
그룹을 사용자 지정 탭에 추가합니다.
그룹에 메뉴를 추가합니다.
메뉴의 (Name) 속성을 CustomerMenu로 설정합니다.
메뉴의 Label 속성을 Customers로 설정합니다.
메뉴의 Dynamic 속성을 true로 설정합니다.

이렇게 하면 Office 응용 프로그램에 리본 메뉴를 로드한 후 런타임에 메뉴의 컨트롤을 추가 및 제거할 수 있습니다.

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As New RibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As New RibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(New RibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = new RibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = new RibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}