Partager via


RibbonToggleButton.Image, propriété

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

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
    Get
    Set
Image Image { get; set; }

Valeur de propriété

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

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.

Sécurité .NET Framework

Voir aussi

Référence

RibbonToggleButton Interface

Microsoft.Office.Tools.Ribbon, espace de noms

Autres ressources

Vue d'ensemble du modèle objet de ruban