RibbonBase.LoadImage 事件
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在 RibbonBase 載入時發生 (如果已設定一或多個控制項的 ImageName 屬性)。
public:
event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler Public Custom Event LoadImage As RibbonLoadImageEventHandler 事件類型
範例
下列範例會快取兩 RibbonButton 個控件的影像。
若要執行此程式碼範例，您必須先執行下列步驟：
將功能區 (Visual Designer) 新增至 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;
}
}
備註
事件 LoadImage 可讓您快取功能區自定義中的影像，以改善效能。
根據預設，每次用戶顯示包含影像的索引標籤時，都會將影像載入功能區。 每當您以程式設計方式變更顯示影像之控件的屬性時，就會重載影像。
LoadImage使用 事件將影像指派給控件。 當使用者在功能區上選取索引標籤時，Microsoft Office 應用程式會使用快取的影像。 如果您在運行時間修改控件屬性，Microsoft Office 應用程式將不會重載控件上的映像。 這可提供您一小的效能提升。
如果您想要快取控件的影像，請設定 控件的 ImageName 屬性。 LoadImage除非您至少設定一個控件的 ImageName 屬性，否則不會引發事件。