通过

RibbonGroup.DialogLauncherClick 事件

  • 项目

在用户单击组中的功能区对话框启动器图标时发生。

命名空间：  Microsoft.Office.Tools.Ribbon
程序集：  Microsoft.Office.Tools.Common（在 Microsoft.Office.Tools.Common.dll 中）

语法

声明
Event DialogLauncherClick As RibbonControlEventHandler

event RibbonControlEventHandler DialogLauncherClick

备注

功能区对话框启动器是出现在组中的一个小图标。用户单击此图标时，可以处理 DialogLauncherClick 事件以打开一个自定义对话框。默认情况下，组没有功能区对话框启动器。有关更多信息，请参见如何：向功能区组添加对话框启动器。

示例

下面的示例演示如何将对话框启动器添加到功能区组，以及如何启动使得用户可以在单击 RibbonGroup 右下角的 RibbonDialogLauncher 图标时选择高级设置的自定义对话框。

若要运行此代码示例，必须先执行下列步骤：

  1. 将一个**“功能区(可视化设计器)”**项添加到 Office 项目中。

  2. 按照如何：向功能区组添加对话框启动器中所述，将 RibbonDialogLauncher 添加到默认组中。

  3. 如果使用的是 Visual Basic，请将一个新的 Windows 窗体**“对话框”项添加到项目中。如果使用的是 C#，请添加一个新的“Windows 窗体”项，然后通过向窗体中添加“确定”和“取消”**按钮并为按钮的单击事件创建事件处理程序将其转换为对话框。

  4. 将该对话框的**“(Name)”**属性设置为 advancedSettingsDialog。可以通过添加控件和设置更多属性来自定义该对话框。

  5. 向代码中添加 DialogLauncherClick 事件处理程序。

  6. 将以下方法的内容放到 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();
}

.NET Framework 安全性

请参见

参考

RibbonGroup 接口

Microsoft.Office.Tools.Ribbon 命名空间

其他资源

如何：向功能区组添加对话框启动器