RibbonDropDownItem.OfficeImageId, propriété

Article
05/16/2013

Obtient ou définit l'image à afficher sur le RibbonDropDownItem, si vous souhaitez utiliser une icône Microsoft Office intégrée.

Espace de noms : Microsoft.Office.Tools.Ribbon
Assembly : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)

Syntaxe

'Déclaration
Property OfficeImageId As String

string OfficeImageId { get; set; }

Valeur de propriété

Type : System.String
Image à afficher sur le RibbonDropDownItem si vous souhaitez utiliser une icône Microsoft Office intégrée.

Notes

La propriété OfficeImageId identifie une icône Office affichée par le contrôle.La valeur de la propriété est une chaîne qui identifie la valeur imageMso de l'icône sélectionnée.Cette propriété peut être définie au moment du design ou de l'exécution.Si vous mettez à jour cette propriété au moment de l'exécution, l'apparence du contrôle est mise à jour pour refléter la modification.

Pour obtenir une liste de valeurs d' imageMso, consultez la page Complément Office 2010 : Galerie d'icônesdu Centre de téléchargement Microsoft.

Cette propriété est ignorée si la propriété Image est définie.Les images identifiées par la propriété OfficeImageId peuvent être chargées légèrement plus rapidement que les images identifiées par la propriété Image car les images sont mises en cache dans l'application Office.

Exemples

L'exemple suivant attribue des icônes Microsoft Office à deux éléments dans une zone déroulante.

Pour exécuter cet exemple de code, vous devez exécuter tout d'abord les étapes suivantes :

Ajoutez un élément Ruban (Concepteur visuel) à un projet créé en utilisant les outils de développement Office dans Visual Studio.
Ajoutez un groupe à un onglet personnalisé.
Ajoutez une zone déroulante au groupe.

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);
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.