Proprietà RibbonSplitButton.OfficeImageId (System 2007)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Ottiene o imposta l'immagine da visualizzare nel controllo RibbonSplitButton se si desidera utilizzare un'icona incorporata di Microsoft Office.

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 OfficeImageId As String

Dim instance As RibbonSplitButton
Dim value As String

value = instance.OfficeImageId

instance.OfficeImageId = value

public 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.

Esempi

Nell'esempio seguente viene assegnata un'icona di Microsoft Office a un pulsante dividi.

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

Aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto Visual Studio Tools per Office.
Aggiungere un gruppo alla scheda personalizzata.
Aggiungere un pulsante dividi al gruppo.

Private Sub SetSplitButtonImage()
    SplitButton1.OfficeImageId = "HighImportance"
End Sub

private void SetSplitButtonImage()
{
    splitButton1.OfficeImageId = "HighImportance";
}

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.