共用方式為


RibbonBase.LoadImage 事件

定義

RibbonBase 載入時發生 (如果已設定一或多個控制項的 ImageName 屬性)。

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;
public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;
member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler 
Public Custom Event LoadImage As RibbonLoadImageEventHandler 

事件類型

範例

下列範例會快取兩 RibbonButton 個控件的影像。

若要執行此程式碼範例,您必須先執行下列步驟:

  • 功能區 (Visual Designer) 新增至 Office 專案。

  • 如果您使用 Visual Basic 專案,請將下列語句新增至功能區程式代碼檔案頂端: Imports Microsoft.Office.Tools.Ribbon

然後,您可以在產生的功能區類別中執行此程序代碼。

Private Sub Ribbon1_LoadImage(sender As Object, e As RibbonLoadImageEventArgs)  
   Select Case e.ImageName  
      Case "Button1Image"  
         e.Image = My.Resources.Image1  
      Case "Button2Image"  
         e.Image = My.Resources.Image2  
   End Select  
End Sub  
private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)  
{  
    switch (e.ImageName)  
    {  
        case "Button1Image":  
            e.Image = Properties.Resources.Image1;  
            break;  
        case "Button2Image":  
            e.Image = Properties.Resources.Image2;  
            break;  
    }  
}  

備註

事件 LoadImage 可讓您快取功能區自定義中的影像,以改善效能。

根據預設,每次用戶顯示包含影像的索引標籤時,都會將影像載入功能區。 每當您以程式設計方式變更顯示影像之控件的屬性時,就會重載影像。

LoadImage使用 事件將影像指派給控件。 當使用者在功能區上選取索引標籤時,Microsoft Office 應用程式會使用快取的影像。 如果您在運行時間修改控件屬性,Microsoft Office 應用程式將不會重載控件上的映像。 這可提供您一小的效能提升。

如果您想要快取控件的影像,請設定 控件的 ImageName 屬性。 LoadImage除非您至少設定一個控件的 ImageName 屬性,否則不會引發事件。

適用於