RibbonBase.LoadImage Evento

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Ribbon

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Si verifica al caricamento di RibbonBase, se la proprietà ImageName è impostata per uno o più controlli.

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

Tipo evento

RibbonLoadImageEventHandler

Esempio

Nell'esempio seguente vengono memorizzate nella cache le immagini per due RibbonButton controlli.

Per eseguire questo esempio di codice, è necessario eseguire prima i passaggi seguenti:

Aggiungere una barra multifunzione (Visual Designer) a un progetto di Office.
Se si usa un progetto Visual Basic, aggiungere l'istruzione seguente all'inizio del file di codice della barra multifunzione: Imports Microsoft.Office.Tools.Ribbon

È quindi possibile eseguire questo codice nella classe Ribbon generata.

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

Commenti

L'evento LoadImage consente di memorizzare nella cache le immagini nella personalizzazione della barra multifunzione, che può migliorare le prestazioni.

Per impostazione predefinita, un'immagine viene caricata nella barra multifunzione ogni volta che l'utente visualizza una scheda contenente l'immagine. Un'immagine viene ricaricata ogni volta che si modificano a livello di codice le proprietà di un controllo in cui viene visualizzata l'immagine.

Usare l'evento LoadImage per assegnare un'immagine a un controllo. Quando l'utente seleziona una scheda sulla barra multifunzione, l'applicazione Microsoft Office usa l'immagine memorizzata nella cache. Se si modifica una proprietà di controllo in fase di esecuzione, l'applicazione Microsoft Office non ricarica l'immagine nel controllo. Questo può offrire un piccolo guadagno di prestazioni.

Se si vuole memorizzare nella cache l'immagine di un controllo, impostare la proprietà ImageName del controllo. L'evento LoadImage non viene generato a meno che non si imposta la proprietà ImageName di almeno un controllo.

Si applica a

Condividi tramite