通过

RibbonSplitButton.ImageName 属性

  • 参考

定义

命名空间:
Microsoft.Office.Tools.Ribbon
程序集:
Microsoft.Office.Tools.Common.dll

获取或设置一个名称，该名称可用于在 E:Microsoft.Office.Tools.Ribbon.LoadImage 事件处理程序中标识控件图像。

public:
 property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };
public string ImageName { get; set; }
member this.ImageName : string with get, set
Public Property ImageName As String

属性值

String

可在 E：Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage 事件处理程序中使用的字符串，用于标识控件的图像。

注解

属性 ImageName 标识控件显示的图像。 Office 应用程序仅从解决方案检索此映像一次，以提高性能。 此属性只能在设计时设置，因为它标识的图像是在事件期间加载的 LoadImage 。 LoadImage 在显示功能区时，每个图像名称仅引发一次。 之后，无法使用此属性更改控件图像。

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

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

适用于