Evento OfficeRibbon.LoadImage (System 2007)
Aggiornamento: novembre 2007
Si verifica al caricamento di OfficeRibbon, se la proprietà ImageName è impostata per uno o più controlli.
Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Sintassi
<RibbonEventAttribute("loadImage")> _
Public Event LoadImage As EventHandler(Of RibbonLoadImageEventArgs)
Dim instance As OfficeRibbon
Dim handler As EventHandler(Of RibbonLoadImageEventArgs)
AddHandler instance.LoadImage, handler
[RibbonEventAttribute("loadImage")]
public event EventHandler<RibbonLoadImageEventArgs> 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 Visual Studio Tools per 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;
}
}
Autorizzazioni
- 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.