RibbonBase.LoadImage 事件

定義

命名空間:

Microsoft.Office.Tools.Ribbon

組件:

Microsoft.Office.Tools.Common.v4.0.Utilities.dll

在 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 

事件類型

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 屬性，否則不會引發事件。