RibbonBase.LoadImage – událost

Článek
08/11/2011

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álostí umožňuje mezipaměť obrazy v přizpůsobení pásu karet, což může zlepšit výkon.

Standardně je pokaždé, když uživatel zobrazí kartu obsahující bitová kopie bitová kopie načten do Pás karet . bitová kopie znovu pokaždé, programově změnit vlastnosti ovládacího prvku se zobrazí bitová kopie .

Použití LoadImage události přiřadit obrázek do ovládacího prvku. Když uživatel vybere kartu na Pás karet, systém Microsoft Office aplikace používá bitová kopiev mezipaměti. Za běhu změníte vlastnost ovládacího prvku,aplikace sady systém Microsoft Officenebude znovu načíst bitová kopie na ovládací prvek. To vám může poskytnout malý výkon zisku.

Pokud chcete bitová kopie ovládacího prvku do mezipaměti, nastavte ImageName vlastnost ovládacího prvku. LoadImage Událost je aktivována, pokud je nastavena 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 je musí provést následující kroky:

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

Potom můžete spustit tento kód vygenerovanétřída Pás 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é

Odkaz

RibbonBase Třída

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

Sdílet prostřednictvím