RibbonLoadImageEventArgs 類別 (2007 系統)

更新：2007 年 11 月

提供 LoadImage 事件的資料。

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

語法

Public NotInheritable Class RibbonLoadImageEventArgs _
    Inherits EventArgs

Dim instance As RibbonLoadImageEventArgs

public sealed class RibbonLoadImageEventArgs : EventArgs

備註

如果您想要載入控制項的 ImageName 屬性所識別的影像，可以操作 LoadImage 事件。Microsoft Office 應用程式只會在顯示功能區時從方案擷取這個影像一次，以提高效能。在此之後，就無法變更控制項影像。

若要載入控制項的影像，請將程式碼加入至 LoadImage 事件處理常式。如果 RibbonLoadImageEventArgs 的 ImageName 屬性符合控制項的 ImageName 屬性，請將 Image 屬性設定為您要載入的影像。

範例

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

若要執行這個程式碼範例，您必須先執行下列步驟：

1. 將 [功能區 (視覺化設計工具)] 項目加入至 Visual Studio Tools for Office 專案。

2. 將群組加入至自訂索引標籤。

3. 將兩個按鈕加入至群組。

4. 將兩個影像加入至專案資源。如需詳細資訊，請參閱 HOW TO：加入或移除資源。

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal 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;
    }
}

繼承階層架構

System.Object
  System.EventArgs
    Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventArgs

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

RibbonLoadImageEventArgs 成員

Microsoft.Office.Tools.Ribbon 命名空間