RibbonBase.LoadImage Událost

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Ribbon

Sestavení:: Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

RibbonLoadImageEventHandler

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

Sdílet prostřednictvím