RibbonDialogLauncher.ImageName 属性 (2007 system)
更新：2007 年 11 月
获取或设置一个标识符，它用于在此 RibbonDialogLauncher 添加到快速访问工具栏时将图像分配给它。
命名空间： Microsoft.Office.Tools.Ribbon
程序集： Microsoft.Office.Tools.Common.v9.0（在 Microsoft.Office.Tools.Common.v9.0.dll 中）
语法
声明
Public Property ImageName As String
用法
Dim instance As RibbonDialogLauncher
Dim value As String
value = instance.ImageName
instance.ImageName = value
public string ImageName { get; set; }
属性值
一个标识符，用于在此 RibbonDialogLauncher 添加到快速访问工具栏时将图像分配给它。
备注
只有在特定条件下，才可以在运行时设置此属性。有关更多信息，请参见功能区对象模型概述。
当 RibbonDialogLauncher 在功能区上的组中显示时，ImageName 属性没有任何可见效果。但是，当用户将 RibbonDialogLauncher 添加到快速访问工具栏时，此属性将控制显示的图像的行为，除非另外还设置了 Image 或 OfficeImageId 属性。
ImageName 属性标识该控件所显示的图像。为了提高性能，Office 应用程序从解决方案中只检索一次此图像。只能在设计时设置此属性，因为它标识的图像在 LoadImage 事件期间加载。在显示功能区时，对于每个图像名称，只会引发一次 LoadImage。此后，不能再使用此属性更改控件图像。
若要加载图像，请在 LoadImage 事件处理程序中添加代码。检查 RibbonLoadImageEventArgs 的 ImageName 属性，将 RibbonLoadImageEventArgs 对象的 Image 属性设置为要加载的图像。
如果设置了 Image 属性或 OfficeImageId 属性，则忽略此属性。加载 ImageName 属性所标识的图像比加载 Image 属性所标识的图像可能稍快一些，这是因为 Office 应用程序仅在首次显示功能区时从解决方案中检索图像。
权限
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。
另请参见
参考
Microsoft.Office.Tools.Ribbon 命名空间