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 應用程式只會在第一次顯示功能區時，從您的解決方案擷取影像。