RibbonGallery 인터페이스

아티클
08/10/2011

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

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

구문

‘선언
<GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")> _
Public Interface RibbonGallery _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

RibbonGallery 형식에서는 다음과 같은 멤버를 노출합니다.

속성

	이름	설명
	Buttons	이 RibbonGallery에 포함된 단추의 컬렉션을 가져옵니다.
	ColumnCount	이 RibbonGallery에 있는 Item 열의 수를 가져오거나 설정합니다.
	ControlSize	RibbonGallery 컨트롤의 크기를 가져오거나 설정합니다.
	Description	메뉴 또는 분할 단추에서 이 RibbonGallery 컨트롤에 나타나는 텍스트를 가져오거나 설정합니다.
	Enabled	이 RibbonControl이 활성화되는지 여부를 나타내는 값을 가져오거나 설정합니다. (RibbonControl에서 상속됨)
	Id	Microsoft Office에서 이 RibbonControl 개체를 식별하는 데 사용하는 문자열을 가져옵니다. (RibbonControl에서 상속됨)
	Image	단추에 표시되는 이미지를 가져오거나 설정합니다.
	ImageName	LoadImage 이벤트 처리기에서 RibbonGallery를 식별하는 데 사용할 수 있는 이름을 가져오거나 설정합니다.
	ItemImageSize	이 RibbonGallery의 항목에 표시되는 이미지의 크기를 지정하는 Size를 가져오거나 설정합니다.
	Items	이 RibbonGallery에 있는 RibbonDropDownItem 구성 요소의 컬렉션을 가져옵니다.
	KeyTip	이 RibbonGallery의 바로 가기 키를 가져오거나 설정합니다.
	Label	이 RibbonGallery에 나타나는 텍스트를 가져오거나 설정합니다.
	Name	이 RibbonComponent의 이름을 가져오거나 설정합니다. (RibbonComponent에서 상속됨)
	OfficeImageId	기본 제공 Microsoft Office 아이콘을 사용하려는 경우 컨트롤에 표시할 이미지를 가져오거나 설정합니다.
	Parent	이 RibbonComponent의 부모를 나타내는 RibbonComponent를 가져옵니다. (RibbonComponent에서 상속됨)
	Position	갤러리가 Microsoft Office 메뉴에 있는 경우 해당 갤러리의 위치를 가져오거나 설정합니다.
	Ribbon	컨트롤 계층 구조가 들어 있는 최상위 Ribbon 개체를 가져옵니다. (RibbonComponent에서 상속됨)
	RibbonUI	인프라입니다. Microsoft Office 응용 프로그램에서 리본 확장성 코드에 제공하는 IRibbonUI 인스턴스를 가져옵니다. (RibbonComponent에서 상속됨)
	RowCount	이 RibbonGallery에 표시되는 RibbonDropDownItem 구성 요소의 행 수를 가져오거나 설정합니다.
	ScreenTip	포인터를 이 RibbonGallery 위로 이동할 때 나타나는 팁 텍스트를 가져오거나 설정합니다.
	SelectedItem	현재 선택된 항목을 가져오거나 설정합니다.
	SelectedItemIndex	현재 선택된 RibbonDropDownItem의 인덱스를 가져오거나 설정합니다.
	ShowImage	RibbonGallery 에 연결된 이미지가 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.
	ShowItemImage	갤러리의 항목에 대해 이미지가 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.
	ShowItemLabel	이 RibbonGallery의 항목에 대해 레이블이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.
	ShowItemSelection	현재 선택된 RibbonDropDownItem이 선택되지 않은 항목과 시각적으로 구별되는지 여부를 나타내는 값을 가져오거나 설정합니다.
	ShowLabel	이 RibbonGallery의 레이블이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.
	Site	IComponent 와 관련된 ISite를 가져오거나 설정합니다 . (IComponent에서 상속됨)
	SuperTip	포인터를 RibbonGallery 위로 이동할 때 나타나는 여러 줄로 된 팁 텍스트를 가져오거나 설정합니다.
	Tag	이 RibbonComponent와 연결된 응용 프로그램별 데이터를 가져오거나 설정합니다. (RibbonComponent에서 상속됨)
	Visible	이 RibbonControl이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. (RibbonControl에서 상속됨)

위쪽

메서드

	이름	설명
	Dispose	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 응용 프로그램 정의 작업을 수행합니다. (IDisposable에서 상속됨)
	PerformDynamicLayout	RibbonComponent 에 동적 메뉴와 같은 동적 부모가 있고 레이아웃이 일시 중단되지 않은 경우 부모 컨트롤의 Microsoft.Office.Core.IRibbonUI.InvalidateControl 메서드를 호출합니다. (RibbonComponent에서 상속됨)
	PerformLayout	RibbonComponent 에 부모가 있고 레이아웃이 일시 중단되지 않은 경우 Microsoft.Office.Core.IRibbonUI.InvalidateControl을 호출합니다. (RibbonComponent에서 상속됨)
	ResumeLayout()	SuspendLayout 메서드의 결과를 되돌립니다. (RibbonComponent에서 상속됨)
	ResumeLayout(Boolean)	SuspendLayout 메서드의 결과를 되돌립니다. (RibbonComponent에서 상속됨)
	SuspendLayout	Microsoft Office 응용 프로그램에서 리본 메뉴의 컨트롤 상태를 새로 고치지 않도록 합니다. (RibbonComponent에서 상속됨)

위쪽

이벤트

	이름	설명
	ButtonClick	사용자가 이 RibbonGallery의 단추를 클릭하는 경우 발생합니다.
	Click	사용자가 이 RibbonGallery의 항목을 클릭하는 경우 발생합니다.
	Disposed	구성 요소의 Disposed 이벤트를 처리하는 메서드를 나타냅니다. (IComponent에서 상속됨)
	ItemsLoading	이 RibbonGallery가 열릴 때 발생합니다.

위쪽

설명

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

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

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

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

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

속성 창에서 Items 속성을 클릭합니다.
줄임표(...)를 클릭합니다.
DropDown 컬렉션 편집기에서 새 항목을 추가하고, 순서를 지정하고, 편집합니다.

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

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

속성 창에서 Buttons 속성을 클릭합니다.
줄임표(...)를 클릭합니다.
Button 컬렉션 편집기에서 새 단추 컨트롤을 추가하고, 순서를 지정하고, 편집합니다.

RibbonFactory 개체의 CreateRibbonGallery 메서드를 사용하여 런타임에 RibbonGallery를 만들 수 있습니다.

다음과 같은 두 가지 방법으로 RibbonFactory 개체에 액세스할 수 있습니다.

리본 클래스의 Factory 속성을 사용합니다. 리본 클래스 내부의 코드에서 이 방법을 사용합니다.
Globals.Factory.GetRibbonFactory 메서드를 사용합니다. 리본 클래스 외부의 코드에서 이 방법을 사용합니다.

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

참고

이 인터페이스는 Visual Studio Tools for Office Runtime에 의해 구현되며 코드에서 직접 구현할 수는 없습니다. 자세한 내용은 Visual Studio Tools for Office 런타임 개요를 참조하십시오.

용도

이 문서에서는 .NET Framework 4를 대상으로 하는 Office 프로젝트에서 사용되는 이 형식의 버전을 설명합니다. .NET Framework 3.5를 대상으로 하는 프로젝트에서는 이 형식의 멤버가 다를 수 있으며 이 형식을 위해 제공되는 코드 예제가 작동하지 않을 수도 있습니다. .NET Framework 3.5를 대상으로 하는 프로젝트의 이 형식에 대한 문서는 Visual Studio 2008 설명서의 다음 참조 섹션을 참조하십시오. https://go.microsoft.com/fwlink/?LinkId=160658.