Sdílet prostřednictvím


RibbonBase.LoadImage – událost

Dochází při RibbonBase načte, pokud ImageName vlastnost 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ěti obrazy ve vlastní nastavení pásu karet, což může zlepšit výkon.

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

Použití LoadImage události přiřazení obrázku k ovládacímu prvku.Když uživatel vybere kartu na pásu karet, používá aplikace Microsoft Office obraz v mezipaměti.Pokud změníte vlastnost ovládacího prvku za běhu, nebude aplikace Microsoft Office znovu načíst obrázek ovládacího 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 jste nenastavili ImageName vlastnost alespoň jeden ovládací prvek.

Příklady

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

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

  • Přidat pásu karet (vizuální návrhář) pro aplikaci Office project.

  • Používáte-li projekt aplikace Visual Basic, přidejte tento příkaz na začátek souboru kódu pásu karet:Imports Microsoft.Office.Tools.Ribbon

Pak spuštěním tohoto kódu 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

Viz také

Referenční dokumentace

RibbonBase Třída

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