RibbonToggleButton.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 屬性已設定,則會忽略 OfficeImageIdImageName 屬性。 雖然 Image 屬性較另外兩個屬性提供更多的控制能力,但是每當控制項更新時,它就會將影像物件傳送至 Office 應用程式,因此可能比較慢。

ShowImage 屬性必須為 true,控制項才能顯示影像。 當您在設計階段設定 Image 屬性時,Visual Studio 會自動將 ShowImage 屬性設定為 true。 如果是在執行階段設定 Image 屬性,您必須在程式碼中,將 ShowImage 屬性設定為 true。

.NET Framework 安全性

請參閱

參考

RibbonToggleButton 介面

Microsoft.Office.Tools.Ribbon 命名空間

其他資源

功能區物件模型概觀