RibbonDialogLauncher.ImageName 屬性
取得或設定當這個 RibbonDialogLauncher 加入至 [快速存取工具列] 時用來指派其影像的識別項。
命名空間： Microsoft.Office.Tools.Ribbon
組件： Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)
語法
'宣告
Property ImageName As String
string ImageName { get; set; }
屬性值
型別：System.String
當這個 RibbonDialogLauncher 加入至 [快速存取工具列] 時用來指派其影像的識別項。
備註
這個屬性只能在特定條件下於執行階段設定。 如需詳細資訊，請參閱功能區物件模型概觀。
當 RibbonDialogLauncher 顯示在功能區的群組中時，ImageName 屬性沒有明顯可見的作用。 不過，除非同時設定了 Image 或 OfficeImageId 屬性，否則當使用者將 RibbonDialogLauncher 加入至 [快速存取工具列] 時，這個屬性就會控制所顯示之影像的行為。
ImageName 屬性可以識別控制項顯示的影像。 Office 應用程式只會從方案擷取這個影像一次，以提高效能。 這個屬性只能在設計階段設定，因為它所識別的影像會於 LoadImage 事件期間載入。 功能區顯示時，只會根據影像名稱引發一次 LoadImage。 之後就不能使用這個屬性變更控制項影像。
若要載入影像，請將程式碼加入至 LoadImage 事件處理常式。 查看 RibbonLoadImageEventArgs 的 ImageName 屬性，並將 RibbonLoadImageEventArgs 物件的 Image 屬性設定為您要載入的影像。
如果 Image 屬性或 OfficeImageId 屬性已設定，則會忽略這個屬性。 因為 Office 應用程式只會在第一次顯示功能區時從方案中擷取影像，所以載入 ImageName 屬性識別的影像時，可能會比載入 Image 屬性識別的影像稍微快一些。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。
請參閱
參考
Microsoft.Office.Tools.Ribbon 命名空間