Interfaccia RibbonLoadImageEventArgs

Articolo
08/11/2011

Fornisce dati per l'evento LoadImage.

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

Sintassi

'Dichiarazione
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs

[GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")]
public interface RibbonLoadImageEventArgs

Il tipo RibbonLoadImageEventArgs espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Image	Ottiene o imposta l'immagine di un controllo della barra multifunzione da caricare.
	ImageName	Ottiene il nome dell'immagine in fase di caricamento nella barra multifunzione.

In alto

Note

Per caricare un'immagine identificata dalla proprietà ImageName di un controllo, gestire l'evento LoadImage. Nell'applicazione di Microsoft Office, per migliorare le prestazioni l'immagine viene recuperata dalla soluzione soltanto una volta quando viene visualizzata la barra multifunzione. Successivamente, l'immagine del controllo non potrà essere modificata.

Per caricare un'immagine per un controllo, aggiungere codice al gestore eventi LoadImage. Se la proprietà ImageName di RibbonLoadImageEventArgs corrisponde alla proprietà ImageName del controllo, impostare la proprietà Image sull'immagine da caricare.

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.
Aggiungere un gruppo alla scheda personalizzata.
Aggiungere due pulsanti al gruppo.
Aggiungere due immagini alle risorse del progetto. Per ulteriori informazioni, vedere Procedura: aggiungere o rimuovere risorse.

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal 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;
    }
}

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Condividi tramite