Sdílet prostřednictvím


RibbonBase.LoadImage Událost

Definice

Vyvolá se při RibbonBase načtení, pokud ImageName vlastnost je nastavena pro jeden nebo více ovládacích prvků.

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 

Event Type

Příklady

Následující příklad ukládá obrázky do mezipaměti pro dva RibbonButton ovládací prvky.

Chcete-li spustit tento příklad kódu, musíte nejprve provést následující kroky:

  • Přidání pásu karet (vizuální Designer) do projektu Office

  • Pokud používáte projekt jazyka Visual Basic, přidejte na začátek souboru kódu pásu karet následující příkaz: Imports Microsoft.Office.Tools.Ribbon

Tento kód pak můžete spustit v generované třídě pásu karet.

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;  
    }  
}  

Poznámky

Událost LoadImage umožňuje ukládat obrázky do mezipaměti v přizpůsobení pásu karet, což může zvýšit výkon.

Ve výchozím nastavení se obrázek načte na pás karet pokaždé, když uživatel zobrazí kartu, která obrázek obsahuje. Obrázek se znovu načte pokaždé, když programově změníte vlastnosti ovládacího prvku, na kterém se obrázek zobrazuje.

Událost slouží LoadImage k přiřazení obrázku k ovládacímu prvku. Když uživatel vybere kartu na pásu karet, aplikace Microsoft Office použije obrázek uložený v mezipaměti. Pokud upravíte vlastnost ovládacího prvku za běhu, aplikace Microsoft Office obrázek na ovládací prvek znovu nenačte. To vám může poskytnout malý nárůst výkonu.

Pokud chcete uložit image ovládacího prvku do mezipaměti, nastavte vlastnost ImageName ovládacího prvku. Událost LoadImage není vyvolána, pokud nenastavíte vlastnost ImageName alespoň jednoho ovládacího prvku.

Platí pro