RibbonGroup 인터페이스

아티클
08/10/2011

리본 메뉴 탭의 컨트롤 그룹을 나타냅니다.

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

구문

‘선언
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

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

속성

	이름	설명
	DialogLauncher	그룹과 연결된 리본 메뉴 대화 상자 표시 아이콘을 가져오거나 설정합니다.
	Id	현재 그룹을 식별하는 문자열을 가져옵니다.
	Items	그룹의 컨트롤을 가져옵니다.
	KeyTip	그룹의 바로 가기 키를 가져오거나 설정합니다.
	Label	그룹의 레이블에 표시되는 텍스트를 가져오거나 설정합니다.
	Name	이 RibbonComponent의 이름을 가져오거나 설정합니다. (RibbonComponent에서 상속됨)
	Parent	이 RibbonComponent의 부모를 나타내는 RibbonComponent를 가져옵니다. (RibbonComponent에서 상속됨)
	Position	기본 제공 탭의 기본 제공 그룹을 기준으로 해당 탭의 그룹 위치를 가져오거나 설정합니다.
	Ribbon	컨트롤 계층 구조가 들어 있는 최상위 Ribbon 개체를 가져옵니다. (RibbonComponent에서 상속됨)
	RibbonUI	인프라입니다. Microsoft Office 응용 프로그램에서 리본 확장성 코드에 제공하는 IRibbonUI 인스턴스를 가져옵니다. (RibbonComponent에서 상속됨)
	Site	IComponent 와 관련된 ISite를 가져오거나 설정합니다 . (IComponent에서 상속됨)
	Tag	이 RibbonComponent와 연결된 응용 프로그램별 데이터를 가져오거나 설정합니다. (RibbonComponent에서 상속됨)
	Visible	그룹이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

위쪽

메서드

	이름	설명
	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에서 상속됨)

위쪽

이벤트

	이름	설명
	DialogLauncherClick	사용자가 그룹에서 리본 메뉴 대화 상자 표시 아이콘을 클릭할 때 발생합니다.
	Disposed	구성 요소의 Disposed 이벤트를 처리하는 메서드를 나타냅니다. (IComponent에서 상속됨)

위쪽

설명

Visual Studio는 도구 상자의 Office 리본 컨트롤탭에서 그룹 컨트롤을 리본 디자이너로 끌어올 경우 RibbonGroup 개체를 만듭니다.

일반 작업

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

Task	멤버
그룹의 컨트롤에 액세스하거나, 그룹에 컨트롤을 추가하거나, 그룹에서 컨트롤을 제거합니다.	Items 속성을 사용합니다.
리본 메뉴 탭에 그룹을 추가합니다.	탭의 Groups 컬렉션에 RibbonGroup 을 추가합니다.
기본 제공 탭에서 기본 제공 그룹의 위치를 기준으로 그룹 위치를 지정합니다.	Position 속성을 사용합니다.

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

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

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

참고

이 인터페이스는 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.