RibbonBase.LoadImage – událost

Článek
01/03/2014

Dochází při RibbonBase načte, pokud ImageName je nastavena pro jeden nebo více ovládacích prvků.

Obor názvů: Microsoft.Office.Tools.Ribbon
Sestavení: Microsoft.Office.Tools.Common.v4.0.Utilities (v Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Syntaxe

'Deklarace
Public Event LoadImage As RibbonLoadImageEventHandler

public event RibbonLoadImageEventHandler LoadImage

Poznámky

LoadImage Události umožňuje mezipaměť obrazy v přizpůsobení pás karet, což může zlepšit výkon.

Ve výchozím nastavení obrázek je načten do pásu pokaždé, když uživatel zobrazí kartu, která obsahuje obrázek.Obraz je znovu načíst pokaždé, když programově změnit vlastnosti ovládacího prvku, ve kterém se zobrazí obrázek.

Použití LoadImage události přiřadit obrázek do ovládacího prvku.Po klepnutí na kartu na pásu karet aplikace Microsoft Office používá obraz v mezipaměti.Pokud změníte vlastnost ovládacího prvku za běhu, aplikace Microsoft Office nebude znovu načíst obrázek v ovládacím prvku.To vám může malý výkon.

Pokud chcete obrázek ovládacího prvku do mezipaměti, nastavte ImageName vlastnost ovládacího prvku.LoadImage Událost není aktivována, pokud je nastavena ImageName vlastnost alespoň jeden ovládací prvek.

Příklady

Následující příklad uloží obrazy pro dva RibbonButton prvky.

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

Přidat pásu karet (vizuální návrhář) do Office project.
Používáte-li projekt aplikace Visual Basic, přidejte následující příkaz na začátek souboru kódu pásu karet:Imports Microsoft.Office.Tools.Ribbon

Tento kód pak můžete spustit v generované třídy 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;
    }
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

RibbonBase Třída

Microsoft.Office.Tools.Ribbon – obor názvů

Sdílet prostřednictvím