Condividi tramite


Proprietà RibbonGallery.Image

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 Image 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.

Sicurezza di .NET Framework

Vedere anche

Riferimenti

RibbonGallery Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Altre risorse

Cenni preliminari sul modello a oggetti della barra multifunzione