RibbonMenu.ImageName 属性 (2007 system)

项目
09/04/2008

更新：2007 年 11 月

获取或设置一个名称，可在 LoadImage 事件处理程序中使用该名称标识菜单的图像。

命名空间： 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 RibbonMenu
Dim value As String

value = instance.ImageName

instance.ImageName = value

public string ImageName { get; set; }

属性值

类型：System.String

可在 LoadImage 事件处理程序中用来标识菜单图像的名称。

备注

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

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

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

若要使该控件显示图像，ShowImage 属性必须为 true。如果在设计时设置 ImageName 属性，Visual Studio Tools for Office 自动将 ShowImage 属性设置为 true。如果在运行时设置 ImageName 属性，则必须在代码中将 ShowImage 属性设置为 true。