RibbonDialogLauncher.ImageName 屬性 (2007 系統)

發行項
08/21/2008

更新：2007 年 11 月

取得或設定當這個 RibbonDialogLauncher 加入至 [快速存取工具列] 時用來指派其影像的識別項。

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

語法

Public Property ImageName As String

Dim instance As RibbonDialogLauncher
Dim value As String

value = instance.ImageName

instance.ImageName = value

public 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 屬性識別的影像稍微快一些。