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 命名空間