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