RibbonBase.LoadImage Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit quand le RibbonBase charge, si la propriété ImageName est définie pour un ou plusieurs contrôles.
public:
event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;
public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;
member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler
Public Custom Event LoadImage As RibbonLoadImageEventHandler
Type d'événement
Exemples
L’exemple suivant met en cache les images pour deux RibbonButton contrôles.
Pour exécuter cet exemple de code, vous devez d’abord effectuer les étapes suivantes :
Ajouter un ruban (Visual Designer) à un projet Office.
Si vous utilisez un projet Visual Basic, ajoutez l’instruction suivante en haut du fichier de code du ruban :
Imports Microsoft.Office.Tools.Ribbon
Vous pouvez ensuite exécuter ce code dans la classe Ribbon générée.
Private Sub Ribbon1_LoadImage(sender As Object, e As RibbonLoadImageEventArgs)
Select Case e.ImageName
Case "Button1Image"
e.Image = My.Resources.Image1
Case "Button2Image"
e.Image = My.Resources.Image2
End Select
End Sub
private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)
{
switch (e.ImageName)
{
case "Button1Image":
e.Image = Properties.Resources.Image1;
break;
case "Button2Image":
e.Image = Properties.Resources.Image2;
break;
}
}
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 déclenché que si vous définissez la propriété ImageName d’au moins un contrôle.