RibbonDropDown.ImageName 属性

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

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

语法

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

属性值

类型:System.String
一个字符串,可在 LoadImage 事件处理程序中用来标识控件的图像。

备注

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

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

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

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

.NET Framework 安全性

请参见

参考

RibbonDropDown 接口

Microsoft.Office.Tools.Ribbon 命名空间

其他资源

功能区对象模型概述