RibbonDialogLauncher 인터페이스

아티클
08/10/2011

그룹에 표시되며 대화 상자를 여는 데 사용할 수 있는 표준화된 작은 아이콘을 나타냅니다.

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

구문

‘선언
<GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")> _
Public Interface RibbonDialogLauncher _
    Inherits IDisposable

[GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable

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

속성

	이름	설명
	Enabled	이 RibbonDialogLauncher가 활성화되는지 여부를 나타내는 값을 가져오거나 설정합니다.
	Image	RibbonDialogLauncher 가 빠른 실행 도구 모음에 추가될 때 이 아이콘에 나타나는 이미지를 가져오거나 설정합니다.
	ImageName	RibbonDialogLauncher 가 빠른 실행 도구 모음에 추가될 때 이 아이콘에 이미지를 할당하는 데 사용되는 식별자를 가져오거나 설정합니다.
	KeyTip	이 RibbonDialogLauncher의 바로 가기 키를 가져오거나 설정합니다.
	OfficeImageId	기본 제공 Microsoft Office 아이콘을 사용하려는 경우 이 RibbonDialogLauncher에 표시할 이미지를 가져오거나 설정합니다.
	Parent	이 RibbonDialogLauncher가 멤버로 속한 RibbonGroup 개체를 가져옵니다.
	Ribbon	이 RibbonDialogLauncher가 배치된 OfficeRibbon을 가져옵니다.
	ScreenTip	포인터를 RibbonDialogLauncher 위로 이동할 때 나타나는 팁 텍스트를 가져오거나 설정합니다.
	SuperTip	포인터를 이 RibbonDialogLauncher 위로 이동할 때 나타나는 여러 줄로 된 팁 텍스트를 가져오거나 설정합니다.
	Visible	이 RibbonDialogLauncher가 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

위쪽

메서드

	이름	설명
	Dispose	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 응용 프로그램 정의 작업을 수행합니다. (IDisposable에서 상속됨)
	ResumeLayout	SuspendLayout 메서드의 결과를 되돌립니다.
	SuspendLayout	Microsoft Office 응용 프로그램에서 OfficeRibbon의 컨트롤 상태를 새로 고치지 않도록 합니다.

위쪽

설명

RibbonDialogLauncher는 기본적으로 그룹의 오른쪽 아래 모퉁이에 표시됩니다.

RibbonDialogLauncher가 리본 메뉴의 그룹에 표시되면 Image, ImageName 및 OfficeImageId 속성은 시각적으로 아무런 영향을 주지 않습니다. 그러나 사용자가 빠른 실행 도구 모음에 RibbonDialogLauncher를 추가하면 이러한 속성은 표시된 이미지의 동작을 제어합니다. 또한 Visible 속성은 RibbonDialogLauncher가 빠른 실행 도구 모음에 표시될 경우 해당 아이콘을 숨기지 않습니다. 사용자는 리본(XML) 항목을 통해 빠른 실행 도구 모음에 RibbonDialogLauncher를 추가할 수 있습니다. 자세한 내용은 리본 개요을 참조하십시오.

RibbonDialogLauncher는 RibbonGroup에만 적용됩니다. RibbonGroup 개체에 RibbonDialogLauncher 형식의 DialogLauncher 멤버가 있습니다. RibbonGroup에 RibbonDialogLauncher를 추가하는 방법에 대한 자세한 내용은 방법: 리본 그룹에 대화 상자 시작 관리자 추가를 참조하십시오.

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

다음과 같은 두 가지 방법으로 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.

예제

다음 예제에서는 리본 그룹에 RibbonDialogLauncher를 추가하는 방법과 사용자가 RibbonGroup의 오른쪽 아래에 있는 RibbonDialogLauncher 아이콘을 클릭하면 고급 설정을 선택할 수 있는 사용자 지정 대화 상자를 실행하는 방법을 보여 줍니다.

이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

Office 프로젝트에 리본(비주얼 디자이너) 항목을 추가합니다.
방법: 리본 그룹에 대화 상자 시작 관리자 추가에 설명된 대로 기본 그룹 Group1에 RibbonDialogLauncher를 추가합니다.
Visual Basic을 사용하는 경우 프로젝트에 새 대화 상자 항목을 추가합니다. C#을 사용하는 경우에는 새 Windows Form 항목을 추가한 다음 이를 대화 상자로 변환합니다. 이렇게 하려면 해당 양식에 확인 및 취소 단추를 추가하고 단추의 클릭 이벤트에 대한 이벤트 처리기를 만듭니다.
대화 상자의 (Name) 속성을 advancedSettingsDialog로 설정합니다. 컨트롤을 추가하고 추가 속성을 설정하여 대화 상자를 사용자 지정할 수 있습니다.
코드에 DialogLauncherClick 이벤트 처리기를 추가합니다.
다음 메서드의 내용을 DialogLauncherClick 이벤트 처리기에 포함합니다.

Private Sub Group1_DialogLauncherClick(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
End Sub

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}