RibbonSplitButton.ImageName 属性
获取或设置一个名称,您可以在 E:Microsoft.Office.Tools.Ribbon.LoadImage 事件处理程序中使用该名称标识控件的图像。
命名空间: Microsoft.Office.Tools.Ribbon
程序集: Microsoft.Office.Tools.Common(在 Microsoft.Office.Tools.Common.dll 中)
语法
声明
Property ImageName As String
string ImageName { get; set; }
属性值
类型:System.String
一个字符串,可在 E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage 事件处理程序中用来标识控件的图像。
备注
ImageName 属性标识该控件所显示的图像。 为了提高性能,Office 应用程序从解决方案中只检索一次此图像。 此属性只能在设计时设置,因为它标识的图像是在 LoadImage 事件过程中加载的。 当显示功能区时,对于每个图像名称,只会引发一次 LoadImage。 此后,不能再使用此属性更改控件图像。
若要加载图像,请在 LoadImage 事件处理程序中添加代码。 检查 RibbonLoadImageEventArgs 的 ImageName 属性,将 RibbonLoadImageEventArgs 对象的 Image 属性设置为要加载的图像。
如果设置了 Image 属性或 OfficeImageId 属性,则忽略此属性。 加载 ImageName 属性所标识的图像比加载 Image 属性所标识的图像可能稍快一些,这是因为 Office 应用程序仅在首次显示功能区时从解决方案中检索图像。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。
请参见
参考
Microsoft.Office.Tools.Ribbon 命名空间