Proprietà RibbonMenu.Image (System 2007)
Aggiornamento: novembre 2007
Ottiene o imposta l'immagine visualizzata nel menu.
Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Sintassi
Public Property Image As Image
Dim instance As RibbonMenu
Dim value As Image
value = instance.Image
instance.Image = value
public Image Image { get; set; }
Valore proprietà
Tipo: System.Drawing.Image
Oggetto Image visualizzato nel menu.
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. Se la proprietà Image viene impostata in fase di progettazione, in Visual Studio Tools per Office la proprietà ShowImage viene impostata automaticamente su true. Se la proprietà Image viene impostata in fase di esecuzione, la proprietà ShowImage va impostata su true nel codice.
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.