共用方式為


RibbonLoadImageEventArgs 介面

提供 LoadImage 事件的資料。

命名空間:  Microsoft.Office.Tools.Ribbon
組件:   Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)
  Microsoft.Office.Tools.Common.v4.0.Utilities (在 Microsoft.Office.Tools.Common.v4.0.Utilities.dll 中)

語法

'宣告
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs
[GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")]
public interface RibbonLoadImageEventArgs

RibbonLoadImageEventArgs 型別會公開下列成員。

屬性

  名稱 說明
公用屬性 Image 取得或設定您想要載入之功能區控制項的影像。
公用屬性 ImageName 取得功能區中所載入之影像的名稱。

回頁首

備註

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

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

範例

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

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

  1. 功能區 (視覺化設計工具) 項目加入至 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;
    }
}

請參閱

參考

Microsoft.Office.Tools.Ribbon 命名空間