Proprietà RibbonButton.Image

Articolo
08/11/2011

Ottiene o imposta l'immagine visualizzata nel pulsante.

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

Sintassi

'Dichiarazione
Property Image As Image
    Get
    Set

Image Image { get; set; }

Valore proprietà

Tipo: System.Drawing.Image
Oggetto Image visualizzato nel pulsante.

Note

Il formato immagine consigliato è PNG, poiché le immagini in questo formato supportano la trasparenza tramite il canale alfa.

La proprietà Image identifica un'immagine visualizzata dal controllo. Tale proprietà può essere impostata in fase di progettazione o in fase di esecuzione. Se la proprietà viene aggiornata in fase di esecuzione, l'aspetto del controllo viene aggiornato a sua volta per riflettere la modifica.

Se la proprietà Image è impostata, le proprietà OfficeImageId e ImageName vengono ignorate. Sebbene la proprietà Image garantisca un maggiore controllo rispetto alle altre due, può risultare più lenta per il fatto che l'oggetto dell'immagine viene inviato all'applicazione di Office ad ogni aggiornamento del controllo.

Perché il controllo sia in grado di visualizzare l'immagine, il valore della proprietà ShowImage deve essere true. Quando si imposta la proprietà Image in fase di progettazione, Visual Studio imposta automaticamente la proprietà ShowImage su true. Se la proprietà Image viene impostata in fase di esecuzione, la proprietà ShowImage va impostata su true nel codice.

Esempi

Nell'esempio riportato di seguito viene impostata la proprietà Image di due pulsanti. Per eseguire questo esempio di codice, effettuare innanzitutto le seguenti operazioni:

Aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto creato utilizzando gli strumenti di sviluppo Office di Visual Studio.
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 LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}

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.