다음을 통해 공유


RibbonGallery 인터페이스

정의

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

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl
특성
구현

설명

인터페이스와 RibbonDropDown 마찬가지로 개체 RibbonGalleryRibbonButton 컨트롤의 RibbonDropDownItem 메뉴를 표시합니다.

인터페이스와 RibbonDropDown 달리 인터페이스는 RibbonGallery 사용자가 를 클릭할 Click 때 이벤트가 아닌 SelectionChanged 이벤트를 발생합니다.RibbonDropDownItem 즉, Click 예를 들어 사용자가 동일한 RibbonDropDownItem 를 두 번 클릭할 때 이벤트가 두 번 발생합니다. (첫 SelectionChanged 번째 클릭 전에 선택한 내용에 따라 에서 동일한 시나리오에 RibbonDropDown대해 초기 선택이 이루어졌을 때 이벤트가 한 번에 발생합니다.)

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

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

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

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

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

  3. DropDown 컬렉션 편집기 새 항목을 추가, 주문 및 편집합니다.

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

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

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

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

  3. 단추 컬렉션 편집기 새 단추 컨트롤을 추가, 정렬 및 편집합니다.

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

RibbonFactory 개체에 액세스하는 방법에는 다음 두 가지가 있습니다.

  • Ribbon 클래스의 Factory 속성 사용. Ribbon 클래스의 코드에서 이 방법을 사용합니다.

  • Globals.Factory.GetRibbonFactory 메서드 사용. Ribbon 클래스 외부 코드에서 이 방법을 사용합니다.

이 컨트롤의 일부 속성은 리본이 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 설명서의 참조 섹션(http://go.microsoft.com/fwlink/?LinkId=160658)을 참조하세요.

속성

Buttons

RibbonGallery의 단추 컬렉션을 가져옵니다.

ColumnCount

이 에서 RibbonGallery항목 열의 수를 가져오거나 설정합니다.

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

RibbonDropDownItem에 표시되는 RibbonGallery 구성 요소의 행 수를 가져오거나 설정합니다.

ScreenTip

포인터를 이 RibbonGallery 위로 이동할 때 나타나는 팁 텍스트를 가져오거나 설정합니다.

SelectedItem

현재 선택된 항목을 가져오거나 설정합니다.

SelectedItemIndex

현재 선택된 RibbonDropDownItem의 인덱스를 가져오거나 설정합니다.

ShowImage

RibbonGallery과 연결된 이미지가 표시되는지를 나타내는 값을 가져오거나 설정합니다.

ShowItemImage

갤러리의 항목에 대한 이미지의 표시 여부를 나타내는 값을 가져오거나 설정합니다.

ShowItemLabel

RibbonGallery의 항목에 대해 레이블이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

ShowItemSelection

현재 선택된 RibbonDropDownItem이 선택되지 않은 항목과 시각적으로 구별되는지 여부를 나타내는 값을 가져오거나 설정합니다.

ShowLabel

RibbonGallery의 레이블이 표시되는지를 나타내는 값을 가져오거나 설정합니다.

SuperTip

포인터를 RibbonGallery 위로 이동할 때 나타나는 여러 줄 팁 텍스트를 가져오거나 설정합니다.

Tag

RibbonComponent와 연결된 애플리케이션별 데이터를 가져오거나 설정합니다.

(다음에서 상속됨 RibbonComponent)
Visible

RibbonControl의 표시 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 RibbonControl)

메서드

PerformDynamicLayout()

RibbonComponent에 동적 메뉴와 같은 동적 부모 항목이 있고 레이아웃이 일시 중단되지 않는 경우 부모 컨트롤의 Microsoft.Office.Core.IRibbonUI.InvalidateControl 메서드를 호출합니다.

(다음에서 상속됨 RibbonComponent)
PerformLayout()

에 부모 항목이 있고 레이아웃이 일시 중단되지 않는 경우 RibbonComponentMicrosoft.Office.Core.IRibbonUI.InvalidateControl을 호출합니다.

(다음에서 상속됨 RibbonComponent)
ResumeLayout()

SuspendLayout() 메서드의 결과를 되돌립니다.

(다음에서 상속됨 RibbonComponent)
ResumeLayout(Boolean)

SuspendLayout() 메서드의 결과를 되돌립니다.

(다음에서 상속됨 RibbonComponent)
SuspendLayout()

Microsoft Office 애플리케이션에서 리본 메뉴의 컨트롤 상태를 새로 고치지 않도록 합니다.

(다음에서 상속됨 RibbonComponent)

이벤트

ButtonClick

사용자가 이 RibbonGallery에서 단추를 클릭할 때 발생합니다.

Click

사용자가 이 RibbonGallery에서 항목을 클릭할 때 발생합니다.

ItemsLoading

RibbonGallery가 열릴 때 발생합니다.

적용 대상