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