RibbonBase.LoadImage 事件
會在 RibbonBase 載入時發生 (如果有一個或多個控制項的 ImageName 屬性已設定的話)。
命名空間： Microsoft.Office.Tools.Ribbon
組件： Microsoft.Office.Tools.Common.v4.0.Utilities (在 Microsoft.Office.Tools.Common.v4.0.Utilities.dll 中)
語法
'宣告
Public Event LoadImage As RibbonLoadImageEventHandler
public event RibbonLoadImageEventHandler LoadImage
備註
LoadImage 事件可讓您在功能區自訂中快取影像，這種作法可以改善效能。
根據預設，每當使用者顯示包含影像的索引標籤時，就會將影像載入至功能區。 每當您以程式設計方式變更顯示影像之控制項的屬性時，就會重新載入影像。
您可以使用 LoadImage 事件指派影像給控制項。 當使用者選取功能區上的索引標籤時，Microsoft Office 應用程式就會使用快取的影像。 如果您在執行階段修改控制項屬性，Microsoft Office 應用程式並不會重新載入控制項上的影像。 這可讓您在效能上得到一點改善。
如果您想要快取控制項的影像，請設定控制項的 ImageName 屬性。 除非您至少設定了一個控制項的 ImageName 屬性，否則不會引發 LoadImage 事件。
範例
下列範例會快取兩個 RibbonButton 控制項的影像。
若要執行這個程式碼範例，您必須先執行下列步驟：
將 [功能區 (視覺化設計工具)] 加入至 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;
}
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。