Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Aggiornamento: novembre 2007
Ottiene o imposta un identificatore utilizzato per assegnare un'immagine all'oggetto RibbonDialogLauncher quando questo viene aggiunto alla barra di accesso rapido.
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 ImageName As String
Dim instance As RibbonDialogLauncher
Dim value As String
value = instance.ImageName
instance.ImageName = value
public string ImageName { get; set; }
Valore proprietà
Tipo: System.String
Identificatore utilizzato per assegnare un'immagine all'oggetto RibbonDialogLauncher quando questo viene aggiunto alla barra di accesso rapido.
Note
Tale proprietà può essere impostata in fase di esecuzione soltanto in determinate circostanze. Per ulteriori informazioni, vedere la classe Cenni preliminari sul modello a oggetti della barra multifunzione.
La proprietà ImageName non ha alcun effetto visibile quando l'oggetto RibbonDialogLauncher viene visualizzato in un gruppo della barra multifunzione. Tuttavia, quando viene aggiunto un oggetto RibbonDialogLauncher alla barra di accesso rapido, tale proprietà controlla il comportamento dell'immagine visualizzata, a meno che non sia impostata anche la proprietà Image o OfficeImageId.
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. La proprietà può essere impostata soltanto in fase di progettazione, poiché l'immagine da essa identificata viene caricata durante l'evento LoadImage. L'oggetto LoadImage viene generato solo una volta per ciascun 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.
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.
Vedere anche
Riferimenti
Spazio dei nomi Microsoft.Office.Tools.Ribbon
Altre risorse
Cenni preliminari sul modello a oggetti della barra multifunzione