Condividi tramite


Evento RibbonBase.LoadImage

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

Spazio dei nomi:  Microsoft.Office.Tools.Ribbon
Assembly:  Microsoft.Office.Tools.Common.v4.0.Utilities (in Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Public Event LoadImage As RibbonLoadImageEventHandler
public event RibbonLoadImageEventHandler LoadImage

Note

L'evento LoadImage consente di memorizzare immagini nella cache della personalizzazione della barra multifunzione per ottenere un miglioramento delle prestazioni.

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

Per assegnare un'immagine a un controllo, utilizzare l'evento LoadImage. Quando si seleziona una scheda nella barra multifunzione, l'applicazione di Microsoft Office utilizza l'immagine memorizzata nella cache. Se si modifica una proprietà del controllo in fase di esecuzione, l'applicazione di Microsoft Office non ricarica l'immagine nel controllo. Questa operazione consente di ottenere un lieve miglioramento delle prestazioni.

Per memorizzare nella cache l'immagine di un controllo, impostare la proprietà ImageName del controllo stesso. L'evento LoadImage non viene generato a meno che non venga impostata la proprietà ImageName di almeno un controllo.

Esempi

Nell'esempio riportato di seguito viene illustrato come memorizzare nella cache le immagini di due controlli RibbonButton.

Per eseguire questo esempio di codice, effettuare innanzitutto le seguenti operazioni:

  • Aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto Office.

  • Se si utilizza un progetto Visual Basic, aggiungere l'istruzione seguente all'inizio del file di codice della barra multifunzione: Imports Microsoft.Office.Tools.Ribbon

Sarà quindi possibile eseguire il 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;
    }
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

RibbonBase Classe

Spazio dei nomi Microsoft.Office.Tools.Ribbon