Proprietà RibbonDropDownItem.OfficeImageId
Ottiene o imposta l'immagine da visualizzare in RibbonDropDownItem se si desidera utilizzare un'icona incorporata di Microsoft Office.
Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Sintassi
'Dichiarazione
Property OfficeImageId As String
string OfficeImageId { get; set; }
Valore proprietà
Tipo: System.String
Immagine da visualizzare in RibbonDropDownItem se si desidera utilizzare un'icona incorporata di Microsoft Office.
Note
La proprietà OfficeImageId identifica un'icona di Office visualizzata dal controllo.Il valore della proprietà è una stringa che identifica il valore imageMso dell'icona selezionata.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.
Per un elenco di valori di imageMso, vedere la pagina Componente aggiuntivo di Office 2010: Raccolta delle iconedell'Area download Microsoft.
Se la proprietà Image è impostata, questa proprietà viene ignorata.Le immagini identificate dalla proprietà OfficeImageId presentano una velocità di caricamento leggermente superiore rispetto alle immagini identificate dalla proprietà Image, poiché vengono memorizzate nella cache dell'applicazione di Office.
Esempi
Nell'esempio seguente vengono assegnate icone di Microsoft Office a due elementi di una casella di riepilogo a discesa.
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 una casella di riepilogo a discesa al gruppo.
Private Sub PopulateDropDown()
Dim status1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
status1.Label = "Away"
status1.OfficeImageId = "PersonaStatusAway"
DropDown1.Items.Add(status1)
Dim status2 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
status2.Label = "Online"
status2.OfficeImageId = "PersonaStatusOnline"
DropDown1.Items.Add(status2)
End Sub
private void PopulateDropDown()
{
RibbonDropDownItem status1 = this.Factory.CreateRibbonDropDownItem();
status1.Label = "Away";
status1.OfficeImageId = "PersonaStatusAway";
dropDown1.Items.Add(status1);
RibbonDropDownItem status2 = this.Factory.CreateRibbonDropDownItem();
status2.Label = "Online";
status2.OfficeImageId = "PersonaStatusOnline";
dropDown1.Items.Add(status2);
}
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
RibbonDropDownItem Interfaccia
Spazio dei nomi Microsoft.Office.Tools.Ribbon
Altre risorse
Cenni preliminari sul modello a oggetti della barra multifunzione