RibbonDialogLauncher.ImageName, propriété
Obtient ou définit un identificateur utilisé pour assigner une image à ce RibbonDialogLauncher lorsqu'il est ajouté à la barre d'outils Accès rapide.
Espace de noms : Microsoft.Office.Tools.Ribbon
Assembly : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)
Syntaxe
'Déclaration
Property ImageName As String
string ImageName { get; set; }
Valeur de propriété
Type : System.String
Identificateur utilisé pour assigner une image à ce RibbonDialogLauncher lorsqu'il est ajouté à la barre d'outils Accès rapide.
Notes
Cette propriété peut être définie au moment de l'exécution uniquement sous certaines conditions. Pour plus d'informations, consultez Vue d'ensemble du modèle objet de ruban.
La propriété ImageName n'a aucun effet visible lorsque le RibbonDialogLauncher est affiché dans un groupe sur le ruban. Toutefois, lorsqu'un utilisateur ajoute un RibbonDialogLauncher à la barre d'outils Accès rapide, cette propriété contrôle le comportement de l'image affichée sauf si la propriété Image ou OfficeImageId est également définie.
La propriété ImageName identifie une image affichée par le contrôle. L'application Office extrait cette image de votre solution une seule fois pour améliorer les performances. Cette propriété peut être définie uniquement au moment du design, parce que l'image qu'elle identifie est chargée pendant l'événement LoadImage. LoadImage est déclenché une seule fois par nom d'image, lorsque le Ruban est affiché. Après cela, l'image du contrôle ne peut pas être modifiée en utilisant cette propriété.
Pour charger l'image, ajoutez le code au gestionnaire d'événements LoadImage. Vérifiez la propriété ImageName du RibbonLoadImageEventArgs et affectez à la propriété Image de l'objet RibbonLoadImageEventArgs l'image que vous voulez charger.
Cette propriété est ignorée si la propriété Image ou la propriété OfficeImageId est définie. Les images identifiées par la propriété ImageName peuvent être chargées légèrement plus rapidement que les images identifiées par la propriété Image étant donné que l'application Office extrait l'image de votre solution uniquement la première fois que le ruban est affiché.
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.
Voir aussi
Référence
RibbonDialogLauncher Interface
Microsoft.Office.Tools.Ribbon, espace de noms