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 添加到快速访问工具栏时,此属性将控制显示的图像的行为,除非另外还设置了 Image 或 OfficeImageId 属性。
ImageName 属性标识该控件所显示的图像。 为了提高性能,Office 应用程序从解决方案中只检索一次此图像。 此属性只能在设计时设置,因为它标识的图像是在 LoadImage 事件过程中加载的。 当显示功能区时,对于每个图像名称,只会引发一次 LoadImage。 此后,不能再使用此属性更改控件图像。
若要加载图像,请在 LoadImage 事件处理程序中添加代码。 检查 RibbonLoadImageEventArgs 的 ImageName 属性,将 RibbonLoadImageEventArgs 对象的 Image 属性设置为要加载的图像。
如果设置了 Image 属性或 OfficeImageId 属性,则忽略此属性。 加载 ImageName 属性所标识的图像比加载 Image 属性所标识的图像可能稍快一些,这是因为 Office 应用程序仅在首次显示功能区时从解决方案中检索图像。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。
请参见
参考
Microsoft.Office.Tools.Ribbon 命名空间