RibbonDialogLauncher.ImageName 属性

获取或设置一个标识符,它用于在此 RibbonDialogLauncher 添加到快速访问工具栏时将图像分配给它。

命名空间:  Microsoft.Office.Tools.Ribbon
程序集:  Microsoft.Office.Tools.Common(在 Microsoft.Office.Tools.Common.dll 中)

语法

声明
Property ImageName As String
string ImageName { get; set; }

属性值

类型:System.String
一个标识符,用于在此 RibbonDialogLauncher 添加到快速访问工具栏时将图像分配给它。

备注

只有在特定条件下,才可以在运行时设置此属性。 有关更多信息,请参见功能区对象模型概述

RibbonDialogLauncher 在功能区上的组中显示时,ImageName 属性没有任何可见效果。 但是,当用户将 RibbonDialogLauncher 添加到快速访问工具栏时,此属性将控制显示的图像的行为,除非另外还设置了 ImageOfficeImageId 属性。

ImageName 属性标识该控件所显示的图像。 为了提高性能,Office 应用程序从解决方案中只检索一次此图像。 此属性只能在设计时设置,因为它标识的图像是在 LoadImage 事件过程中加载的。 当显示功能区时,对于每个图像名称,只会引发一次 LoadImage。 此后,不能再使用此属性更改控件图像。

若要加载图像,请在 LoadImage 事件处理程序中添加代码。 检查 RibbonLoadImageEventArgsImageName 属性,将 RibbonLoadImageEventArgs 对象的 Image 属性设置为要加载的图像。

如果设置了 Image 属性或 OfficeImageId 属性,则忽略此属性。 加载 ImageName 属性所标识的图像比加载 Image 属性所标识的图像可能稍快一些,这是因为 Office 应用程序仅在首次显示功能区时从解决方案中检索图像。

.NET Framework 安全性

请参见

参考

RibbonDialogLauncher 接口

Microsoft.Office.Tools.Ribbon 命名空间

其他资源

功能区对象模型概述