RibbonDialogLauncher.Image 屬性

取得或設定當這個 RibbonDialogLauncher 加入至 [快速存取工具列] 時出現在其中的影像。

命名空間： Microsoft.Office.Tools.Ribbon
組件： Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)

語法

'宣告
Property Image As Image

Image Image { get; set; }

型別：System.Drawing.Image
當這個 RibbonDialogLauncher 加入至 [快速存取工具列] 時出現在其中的影像。

建議的影像格式為 PNG，因為 PNG 格式的影像會透過 Alpha 色頻 (Alpha Channel) 支援透明度。

當 RibbonDialogLauncher 顯示在功能區的群組中時，Image 屬性沒有明顯可見的作用。不過，當使用者將 RibbonDialogLauncher 加入至 [快速存取工具列] 時，這個屬性就會控制所顯示之影像的行為。

Image 屬性可以識別控制項顯示的影像。這個屬性可以在設計階段或執行階段設定。如果您在執行階段更新這個屬性，則控制項的外觀會更新以反應變更。

如果 Image 屬性已設定，則會忽略 OfficeImageId 和 ImageName 屬性。雖然 Image 屬性較另外兩個屬性提供更多的控制能力，但是每當控制項更新時，它就會將影像物件傳送至 Office 應用程式，因此可能比較慢。