OfficeRibbon.LoadImage, événement (System 2007)
Mise à jour : novembre 2007
Se produit lorsque le OfficeRibbon charge, si la propriété ImageName est définie pour un ou plusieurs contrôles.
Espace de noms : Microsoft.Office.Tools.Ribbon
Assembly : Microsoft.Office.Tools.Common.v9.0 (dans Microsoft.Office.Tools.Common.v9.0.dll)
Syntaxe
<RibbonEventAttribute("loadImage")> _
Public Event LoadImage As EventHandler(Of RibbonLoadImageEventArgs)
Dim instance As OfficeRibbon
Dim handler As EventHandler(Of RibbonLoadImageEventArgs)
AddHandler instance.LoadImage, handler
[RibbonEventAttribute("loadImage")]
public event EventHandler<RibbonLoadImageEventArgs> LoadImage
Notes
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 dès que vous modifiez par programme les propriétés d'un contrôle sur lequel l'image apparaît.
Utilisez l'événement LoadImage pour assigner 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 permet d'obtenir un petit gain en termes 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é à moins que vous ne définissiez la propriété ImageName d'au moins un contrôle.
Exemples
L'exemple suivant met en cache les images pour deux contrôles RibbonButton.
Pour exécuter cet exemple de code, vous devez exécuter tout d'abord les étapes suivantes :
Ajoutez un Ruban (Concepteur visuel) à un projet Visual Studio Tools pour 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 exécuter ensuite ce code dans la classe du ruban 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;
}
}
Autorisations
- 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.