RibbonButton.Image, propriété

Article
01/06/2014

Obtient ou définit l'image affichée sur le bouton.

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

Syntaxe

'Déclaration
Property Image As Image

Image Image { get; set; }

Valeur de propriété

Type : System.Drawing.Image
Image qui est affiché sur le bouton.

Notes

Le format PNG est le format d'image recommandé étant donné que les images au format PNG prennent en charge la transparence par l'intermédiaire de leur canal alpha.

La propriété Image identifie une image affichée par le contrôle. Cette propriété peut être définie au moment du design ou de l'exécution. Si vous mettez à jour cette propriété au moment de l'exécution, l'apparence du contrôle est mise à jour pour refléter la modification.

Si la propriété Image est définie, les propriétés OfficeImageId et ImageName sont ignorées. Bien que la propriété Image vous donne plus de contrôle que les deux autres propriétés, cela peut être plus lent étant donné que l'objet d'image est envoyé à l'application Office à chaque mise à jour du contrôle.

Pour que le contrôle affiche l'image, la propriété ShowImage doit avoir la valeur true. Lorsque vous définissez la propriété Image au moment du design, Visual Studio définit automatiquement la propriété ShowImage à true. Si vous définissez la propriété Image au moment de l'exécution, vous devez affecter à la propriété ShowImage la valeur true dans votre code.

Exemples

L'exemple de code suivant définit la propriété Image de deux boutons. 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 créé en utilisant les outils de développement Office dans Visual Studio.
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 LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}

Sécurité .NET Framework

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.