Partager via


RibbonLoadImageEventArgs, classe (System 2007)

Mise à jour : novembre 2007

Fournit des données pour l'événement LoadImage.

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

Syntaxe

Public NotInheritable Class RibbonLoadImageEventArgs _
    Inherits EventArgs

Dim instance As RibbonLoadImageEventArgs
public sealed class RibbonLoadImageEventArgs : EventArgs

Notes

Gérez l'événement LoadImage si vous souhaitez charger une image identifiée par la propriété ImageName d'un contrôle. L'application Microsoft Office extrait uniquement une fois cette image de votre solution lorsque le ruban est affiché pour améliorer les performances. Après cela, l'image du contrôle ne peut pas être modifiée.

Pour charger une image pour un contrôle, ajoutez du code au gestionnaire d'événements LoadImage. Si la propriété ImageName du RibbonLoadImageEventArgs correspond à la propriété ImageName du contrôle, affectez à la propriété Image l'image que vous voulez charger.

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 :

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

  2. Ajoutez un groupe à un onglet personnalisé.

  3. Ajoutez deux boutons au groupe.

  4. Ajoutez deux images aux ressources du projet. Pour plus d'informations, consultez Comment : ajouter ou supprimer des ressources.

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal 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;
    }
}

Hiérarchie d'héritage

System.Object
  System.EventArgs
    Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventArgs

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Membres RibbonLoadImageEventArgs

Microsoft.Office.Tools.Ribbon, espace de noms