RibbonOfficeMenu 클래스(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)

구문

Public NotInheritable Class RibbonOfficeMenu _
    Inherits RibbonComponent

Dim instance As RibbonOfficeMenu

public sealed class RibbonOfficeMenu : RibbonComponent

설명

프로젝트에 리본(비주얼 디자이너) 항목을 추가하면 Visual Studio Tools for Office에서는 생성된 OfficeRibbon 클래스의 OfficeMenu 속성에 새 RibbonOfficeMenu 개체를 자동으로 할당합니다. 이 개체를 사용하여 런타임에 Microsoft Office 메뉴에 새 컨트롤을 추가하거나 Microsoft Office 메뉴에 추가한 컨트롤에 액세스할 수 있습니다.

런타임에 리본 메뉴가 로드되기 전에 한해 컨트롤을 추가할 수 있습니다. 컨트롤의 인스턴스를 만든 다음 Items 컬렉션에 새 컨트롤을 추가합니다. 자세한 내용은 리본 개체 모델 개요를 참조하십시오.

예제

다음 예제에서는 Office 리본 메뉴의 사용자 지정 컨트롤을 반복하고 해당 이름을 표시합니다. 이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

리본(비주얼 디자이너) 항목을 Visual Studio Tools for Office 프로젝트에 추가합니다.
Microsoft Office 단추에 단추를 추가합니다.
단추의 (Name) 속성을 myOfficeMenuButton으로 설정합니다.
Position 속성 아래에서 PositionType 속성을 AfterOfficeID로 설정합니다.
Position 속성 아래에서 OfficeID 속성을 FilePrintMenu로 설정합니다.

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub

private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}