Proprietà RibbonSplitButton.ImageName
Ottiene o imposta il nome utilizzabile nel gestore eventi E:Microsoft.Office.Tools.Ribbon.LoadImage per identificare un'immagine per il controllo.
Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Sintassi
'Dichiarazione
Property ImageName As String
Get
Set
string ImageName { get; set; }
Valore proprietà
Tipo: System.String
Stringa utilizzabile nel gestore eventi E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage per identificare un'immagine per il controllo.
Note
La proprietà ImageName identifica un'immagine visualizzata dal controllo. Nell'applicazione di Office, l'immagine viene recuperata dalla soluzione soltanto una volta per migliorare le prestazioni. Questa proprietà può essere impostata solo in fase di progettazione, perché l'immagine che identifica viene caricata durante l'evento LoadImage. LoadImage viene generato solo una volta per nome dell'immagine, quando viene visualizzata la Barra multifunzione. Successivamente non sarà possibile modificare l'immagine del controllo mediante questa proprietà.
Per caricare l'immagine, aggiungere codice al gestore eventi LoadImage. Selezionare la proprietà ImageName di RibbonLoadImageEventArgs e impostare la proprietà Image dell'oggetto RibbonLoadImageEventArgs sull'immagine da caricare.
Se la proprietà Image o OfficeImageId è impostata, tale proprietà viene ignorata. Le immagini identificate dalla proprietà ImageName presentano una velocità di caricamento leggermente superiore rispetto alle immagini identificate dalla proprietà Image, poiché nell'applicazione di Office l'immagine viene recuperata dalla soluzione soltanto la prima volta che la barra multifunzione viene visualizzata.
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.
Vedere anche
Riferimenti
Spazio dei nomi Microsoft.Office.Tools.Ribbon
Altre risorse
Cenni preliminari sul modello a oggetti della barra multifunzione