ButtonBase.Image Property
Gets or sets the image that is displayed on a button control.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
When the Image property is set, the ImageList property will be set to null, and the ImageIndex property will be set to its default, -1.
Note |
|---|
If the FlatStyle property is set to FlatStyle.System, any images assigned to the Image property are not displayed. |
The following code example uses the derived class, Button and sets some of its common properties. The result will be a flat button with text on the left and an image on the right. This code requires that you have a bitmap image named MyBitMap.bmp stored in the C:\Graphics directory, and that a reference to the System.Drawing namespace is included.
private void SetMyButtonProperties() { // Assign an image to the button. button1.Image = Image.FromFile("C:\\Graphics\\MyBitmap.bmp"); // Align the image and text on the button. button1.ImageAlign = ContentAlignment.MiddleRight; button1.TextAlign = ContentAlignment.MiddleLeft; // Give the button a flat appearance. button1.FlatStyle = FlatStyle.Flat; }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Note