RibbonGallery.Image 屬性
取得或設定顯示在按鈕上的影像。
命名空間: Microsoft.Office.Tools.Ribbon
組件: Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)
語法
'宣告
Property Image As Image
Image Image { get; set; }
屬性值
型別:System.Drawing.Image
顯示在按鈕上的 Image。
備註
建議的影像格式為 PNG,因為 PNG 格式的影像會透過 Alpha 色頻 (Alpha Channel) 支援透明度。
Image 屬性可以識別控制項顯示的影像。 這個屬性可以在設計階段或執行階段設定。 如果您在執行階段更新這個屬性,則控制項的外觀會更新以反應變更。
如果 Image 屬性已設定,則會忽略 OfficeImageId 和 ImageName 屬性。 雖然 Image 屬性較另外兩個屬性提供更多的控制能力,但是每當控制項更新時,它就會將影像物件傳送至 Office 應用程式,因此可能比較慢。
ShowImage 屬性必須為 true,控制項才能顯示影像。 當您在設計階段設定 Image 屬性時,Visual Studio 會自動將 ShowImage 屬性設定為 true。 如果是在執行階段設定 Image 屬性,您必須在程式碼中,將 ShowImage 屬性設定為 true。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。
請參閱
參考
Microsoft.Office.Tools.Ribbon 命名空間