RibbonGroup.DialogLauncherClick 이벤트(2007 시스템)

아티클
08/22/2008

업데이트: 2007년 11월

사용자가 그룹에서 리본 메뉴 대화 상자 표시 아이콘을 클릭할 때 발생합니다.

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

구문

Public Event DialogLauncherClick As EventHandler(Of RibbonControlEventArgs)

Dim instance As RibbonGroup
Dim handler As EventHandler(Of RibbonControlEventArgs)

AddHandler instance.DialogLauncherClick, handler

public event EventHandler<RibbonControlEventArgs> DialogLauncherClick

설명

리본 메뉴 대화 상자 표시 아이콘은 그룹에 나타나는 작은 아이콘입니다. 사용자가 이 아이콘을 클릭할 때 DialogLauncherClick 이벤트를 처리하여 사용자 지정 대화 상자를 열 수 있습니다. 기본적으로는 그룹에 리본 메뉴 대화 상자 표시 아이콘이 없습니다. 자세한 내용은 방법: 리본 그룹에 대화 상자 시작 관리자 추가를 참조하십시오.

예제

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

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

리본(비주얼 디자이너) 항목을 Visual Studio Tools for Office 프로젝트에 추가합니다.
방법: 리본 그룹에 대화 상자 시작 관리자 추가에 설명된 대로 기본 그룹에 RibbonDialogLauncher를 추가합니다.
Visual Basic을 사용하는 경우 프로젝트에 새 Windows Form 대화 상자 항목을 추가합니다. 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();
}