Condividi tramite


Proprietà RibbonDropDown.OfficeImageId

Ottiene o imposta l'immagine da visualizzare in RibbonDropDown 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
    Get
    Set
string OfficeImageId { get; set; }

Valore proprietà

Tipo: System.String
ID di un'icona incorporata di Microsoft Office che funge da icona per il controllo.

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 imageMso visitare la pagina 2007 Office System Add-In: Icons Gallery nell'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.

Perché il controllo sia in grado di visualizzare l'immagine, il valore della proprietà ShowImage deve essere true. Quando si imposta la proprietà OfficeImageId in fase di progettazione, Visual Studio imposta automaticamente la proprietà ShowImage su true. Se la proprietà OfficeImageId viene impostata in fase di esecuzione, la proprietà ShowImage va impostata su true nel codice.

Esempi

Nell'esempio seguente viene assegnata un'icona di Microsoft Office a una casella di riepilogo a discesa.

Per eseguire questo esempio di codice, effettuare innanzitutto le seguenti operazioni:

  1. Aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto Office.

  2. Aggiungere un gruppo alla scheda personalizzata.

  3. Aggiungere una casella di riepilogo a discesa al gruppo.

Private Sub SetDropDownImage()
    DropDown1.OfficeImageId = "FilterToggleFilter"
    DropDown1.ShowImage = True
End Sub
private void SetDropDownImage()
{
    dropDown1.OfficeImageId = "FilterToggleFilter";
    dropDown1.ShowImage = true;
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

RibbonDropDown Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Altre risorse

Cenni preliminari sul modello a oggetti della barra multifunzione