RibbonButton.Image, propriété (System 2007)

Article
09/04/2008

Mise à jour : novembre 2007

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

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

Syntaxe

Public Property Image As Image

Dim instance As RibbonButton
Dim value As Image

value = instance.Image

instance.Image = value

public 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 Tools pour Office affecte automatiquement à la propriété ShowImage la valeur 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 Visual Studio Tools pour 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 LoadImages()
    button1.ShowImage = True
    CustomerButton.ShowImage = True
    Button1.Image = My.Resources.Image1
    CustomerButton.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;
}

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.