RibbonBase.LoadImage Zdarzenie

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Ribbon

Zestaw:: Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Występuje podczas RibbonBase ładowania, jeśli właściwość ImageName jest ustawiona dla co najmniej jednej kontrolki.

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

Typ zdarzenia

RibbonLoadImageEventHandler

Przykłady

Poniższy przykład buforuje obrazy dla dwóch RibbonButton kontrolek.

Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:

Dodaj wstążkę (Visual Projektant) do projektu pakietu Office.
Jeśli używasz projektu Visual Basic, dodaj następującą instrukcję na początku pliku kodu wstążki: Imports Microsoft.Office.Tools.Ribbon

Następnie możesz uruchomić ten kod w generowanej klasie wstążki.

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

Uwagi

Zdarzenie LoadImage umożliwia buforowanie obrazów w dostosowywaniu wstążki, co może poprawić wydajność.

Domyślnie obraz jest ładowany do wstążki za każdym razem, gdy użytkownik wyświetla kartę zawierającą obraz. Obraz jest ładowany ponownie za każdym razem, gdy programowo zmieniasz właściwości kontrolki, na której pojawia się obraz.

LoadImage Użyj zdarzenia, aby przypisać obraz do kontrolki. Gdy użytkownik wybierze kartę na wstążce, aplikacja pakietu Microsoft Office używa buforowanego obrazu. Jeśli zmodyfikujesz właściwość kontrolki w czasie wykonywania, aplikacja pakietu Microsoft Office nie załaduje ponownie obrazu w kontrolce. Może to zapewnić niewielki wzrost wydajności.

Jeśli chcesz buforować obraz kontrolki, ustaw właściwość ImageName kontrolki. Zdarzenie LoadImage nie jest zgłaszane, chyba że ustawiono właściwość ImageName co najmniej jednej kontrolki.

Dotyczy

Udostępnij przez