RibbonGroup.DialogLauncherClick 事件 (2007 system)

项目
09/04/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 窗体“对话框”项添加到项目中。如果使用的是 C#，请添加一个新的“Windows 窗体”项，然后通过向窗体中添加“确定”和“取消”按钮并为按钮的单击事件创建事件处理程序将其转换为对话框。
将该对话框的“(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();
}