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 屬性已設定，則會忽略這個屬性。因為 Office 應用程式只會在第一次顯示功能區時從方案中擷取影像，所以載入 ImageName 屬性識別的影像時，可能會比載入 Image 屬性識別的影像稍微快一些。