RibbonLoadImageEventArgs, interface

Article
01/06/2014

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

Espace de noms : Microsoft.Office.Tools.Ribbon
Assemblys : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)
Microsoft.Office.Tools.Common.v4.0.Utilities (dans Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Syntaxe

'Déclaration
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs

[GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")]
public interface RibbonLoadImageEventArgs

Le type RibbonLoadImageEventArgs expose les membres suivants.

Propriétés

	Nom	Description
	Image	Obtient ou définit l'image d'un contrôle de ruban que vous souhaitez charger.
	ImageName	Obtient le nom de l'image chargée dans le ruban.

Début

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 :

Ajoutez un élément Ruban (Concepteur visuel) à un projet Office.
Ajoutez un groupe à un onglet personnalisé.
Ajoutez deux boutons au groupe.
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;
    }
}

Voir aussi

Référence

Microsoft.Office.Tools.Ribbon, espace de noms

Partager via