RibbonDialogLauncher 类 (2007 system)
更新：2007 年 11 月
表示组中可用来打开对话框的标准化小图标。
命名空间： Microsoft.Office.Tools.Ribbon
程序集： Microsoft.Office.Tools.Common.v9.0（在 Microsoft.Office.Tools.Common.v9.0.dll 中）
语法
声明
Public NotInheritable Class RibbonDialogLauncher _
Implements IDisposable
用法
Dim instance As RibbonDialogLauncher
public sealed class RibbonDialogLauncher : IDisposable
备注
RibbonDialogLauncher 默认情况下显示在组的右下角。
当 RibbonDialogLauncher 在功能区上的组中显示时，Image、ImageName 和 OfficeImageId 属性没有任何可见效果。但是，当用户将 RibbonDialogLauncher 添加到快速访问工具栏时，这些属性将控制显示的图像的行为。而且，当 RibbonDialogLauncher 在快速访问工具栏上显示时，Visible 属性不会将其隐藏。用户可以通过“功能区(XML)”项将 RibbonDialogLauncher 添加到快速访问工具栏。有关更多信息，请参见功能区概述。
RibbonDialogLauncher 仅应用于 RibbonGroup。RibbonGroup 类有一个 RibbonDialogLauncher 类型的 DialogLauncher 成员。有关如何将 RibbonDialogLauncher 添加到 RibbonGroup 的信息，请参见如何：向功能区组添加对话框启动器。
此控件的某些属性只能在功能区加载到 Office 应用程序之前设置。有关如何设置这些属性的信息，请参见功能区对象模型概述。
示例
下面的示例演示如何将一个 RibbonDialogLauncher 添加到功能区组，以及如何启动使得用户可以在单击 RibbonGroup 右下角的 RibbonDialogLauncher 图标时选择高级设置的自定义对话框。
若要运行此代码示例，必须先执行下列步骤：
将一个“功能区(可视化设计器)”项添加到 Visual Studio Tools for Office 项目。
按照如何：向功能区组添加对话框启动器中所述，将一个 RibbonDialogLauncher 添加到默认组 Group1 中。
如果使用的是 Visual Basic，请将一个新的“对话框”项添加到项目中。如果使用的是 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();
}
继承层次结构
System.Object
Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
线程安全
此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。
另请参见
参考
Microsoft.Office.Tools.Ribbon 命名空间