다음을 통해 공유


RibbonGallery 클래스(2007 시스템)

업데이트: 2007년 11월

RibbonDropDownItem 개체 및 RibbonButton 컨트롤의 메뉴를 표시하는 컨트롤을 나타냅니다.

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

구문

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

Dim instance As RibbonGallery
[ToolboxBitmapAttribute(typeof(RibbonGallery), "RibbonGallery.bmp")]
public sealed class RibbonGallery : RibbonControl

설명

RibbonDropDown 클래스와 마찬가지로 RibbonGallery에는 RibbonDropDownItem 개체 및 RibbonButton 컨트롤의 메뉴가 표시됩니다.

RibbonDropDown 클래스와 달리 RibbonGallery 클래스에서는 사용자가 RibbonDropDownItem을 클릭할 때 SelectionChanged 이벤트 대신 Click 이벤트를 발생시킵니다. 따라서 사용자가 동일한 RibbonDropDownItem을 두 번 클릭하면 Click 이벤트가 두 번 발생합니다. SelectionChanged 이벤트의 경우에는 RibbonDropDown에서 동일한 상황이라도 처음 클릭하기 전의 선택 항목이 무엇이었는지에 따라 처음 항목을 선택할 때 한 번만 이벤트가 발생합니다.

ShowItemSelection 속성은 현재 선택된 RibbonDropDownItem이 선택되지 않은 항목과 시각적으로 구별되는지 여부를 제어합니다. RibbonGallery에서는 한 번에 한 항목만 선택할 수 있습니다.

ItemImageSize 속성은 16x16 및 32x32 이외의 이미지 크기를 지정하는 데 사용할 수 있습니다.

디자인 타임 또는 런타임에 RibbonGallery에 RibbonDropDownItem 개체를 추가할 수 있습니다.

디자인 타임에 RibbonDropDownItem 개체를 추가하려면

  1. 속성 창에서 Items 속성을 클릭합니다.

  2. 줄임표(...)를 클릭합니다.

  3. DropDown 컬렉션 편집기에서 새 항목을 추가하고, 순서를 지정하고, 편집합니다.

다음 단계에서는 런타임에 RibbonDropDownItem을 추가하는 방법을 설명합니다.

런타임에 RibbonDropDownItem 개체를 추가하려면

  1. RibbonDropDownItem를 사용하여 새 RibbonDropDownItem을 만듭니다.

  2. 만든 RibbonDropDownItem을 이 RibbonGallery 개체의 Items 컬렉션에 추가합니다.

디자인 타임에 RibbonGallery에 RibbonButton 컨트롤을 추가할 수 있습니다.

디자인 타임에 RibbonButton 컨트롤을 추가하려면

  1. 속성 창에서 Buttons 속성을 클릭합니다.

  2. 줄임표(...)를 클릭합니다.

  3. Button 컬렉션 편집기에서 새 단추 컨트롤을 추가하고, 순서를 지정하고, 편집합니다.

이 컨트롤의 일부 속성은 Office 응용 프로그램에 리본 메뉴가 로드되기 전 또는 런타임에 동적 메뉴에 컨트롤이 추가되기 전에만 설정할 수 있습니다. 이러한 속성 설정에 대한 자세한 내용은 리본 개체 모델 개요를 참조하십시오.

상속 계층 구조

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonGallery

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

참고 항목

참조

RibbonGallery 멤버

Microsoft.Office.Tools.Ribbon 네임스페이스

기타 리소스

리본 개요

리본 디자이너

리본 개체 모델 개요

방법: 리본 메뉴 사용자 지정 시작