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
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.