Partager via


OfficeRibbon.LoadImage Événement

Définition

Se produit quand le OfficeRibbon charge, si la propriété ImageName est définie pour un ou plusieurs contrôles.

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;
event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;
member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler 
Event LoadImage As RibbonLoadImageEventHandler 

Type d'événement

Remarques

L’événement LoadImage vous permet de mettre en cache des images dans la personnalisation du ruban, ce qui peut améliorer les performances.

Par défaut, une image est chargée dans le ruban chaque fois que l’utilisateur affiche un onglet qui contient l’image. Une image est rechargée chaque fois que vous modifiez par programmation les propriétés d’un contrôle sur lequel l’image apparaît.

Utilisez l’événement LoadImage pour affecter une image à un contrôle. Lorsque l’utilisateur sélectionne un onglet sur le ruban, l’application Microsoft Office utilise l’image mise en cache. Si vous modifiez une propriété de contrôle au moment de l’exécution, l’application Microsoft Office ne recharge pas l’image sur le contrôle. Cela peut vous donner un petit gain de performances.

Si vous souhaitez mettre en cache l’image d’un contrôle, définissez la propriété ImageName du contrôle. L’événement LoadImage n’est pas déclenché, sauf si vous définissez la propriété ImageName d’au moins un contrôle.

S’applique à