Partager via


RibbonMenu.OfficeImageId, propriété (System 2007)

Mise à jour : novembre 2007

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

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

Syntaxe

Public Property OfficeImageId As String

Dim instance As RibbonMenu
Dim value As String

value = instance.OfficeImageId

instance.OfficeImageId = value
public string OfficeImageId { get; set; }

Valeur de propriété

Type : System.String

ID d'une icône Microsoft Office intégrée qui sert d'icône pour ce menu.

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 imageMso, consultez la page du Centre de téléchargement Microsoft Complément 2007 Office System : galerie d'icônes (en anglais).

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.

Pour que le contrôle affiche l'image, la propriété ShowImage doit avoir la valeur true. Lorsque vous définissez la propriété OfficeImageId au moment du design, Visual Studio Tools pour Office affecte automatiquement à la propriété ShowImage la valeur true. Si vous définissez la propriété OfficeImageId au moment de l'exécution, vous devez affecter à la propriété ShowImage la valeur true dans votre code.

Exemples

L'exemple suivant attribue une icône Microsoft Office à un menu.

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

  1. Ajoutez un élément Ruban (Concepteur visuel) à un projet Visual Studio Tools pour Office.

  2. Ajoutez un groupe à un onglet personnalisé.

  3. Ajoutez un menu au groupe.

  4. Affectez à la propriété Dynamic du menu la valeur true.

Private Sub SetMenuImage()
    Menu1.OfficeImageId = "HighImportance"
    Menu1.ShowImage = True
End Sub
private void SetMenuImage()
{
    menu1.OfficeImageId = "HighImportance";
    menu1.ShowImage = true;
}

Autorisations

Voir aussi

Référence

RibbonMenu, classe

Membres RibbonMenu

Microsoft.Office.Tools.Ribbon, espace de noms