Control.BackgroundImage 屬性

定義

取得或設定在控制項中顯示的背景影像。

C#
public virtual System.Drawing.Image BackgroundImage { get; set; }
C#
public virtual System.Drawing.Image? BackgroundImage { get; set; }

屬性值

表示要在控制項背景中顯示之影像的 Image

範例

下列程式碼範例會將 新增 Button 至表單,並設定其一些通用屬性。 此範例會將按鈕錨定在表單右下角,讓它在表單調整大小時保留其相對位置。 接下來,它會將 和 按鈕的大小設定 BackgroundImage 為與 Image 相同的大小。 此範例接著會將 TabStop 設定為 true ,並設定 TabIndex 屬性。 最後,它會新增事件處理常式來處理 Click 按鈕的事件。 此範例需要您有 ImageList 名為 imageList1 的 。

C#
// Add a button to a form and set some of its common properties.
private void AddMyButton()
{
   // Create a button and add it to the form.
   Button button1 = new Button();

   // Anchor the button to the bottom right corner of the form
   button1.Anchor = (AnchorStyles.Bottom | AnchorStyles.Right);

   // Assign a background image.
   button1.BackgroundImage = imageList1.Images[0];

   // Specify the layout style of the background image. Tile is the default.
   button1.BackgroundImageLayout = ImageLayout.Center;
   
   // Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size;

   // Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1;
   button1.TabStop = true;

   // Add a delegate to handle the Click event.
   button1.Click += new System.EventHandler(this.button1_Click);

   // Add the button to the form.
   this.Controls.Add(button1);
}

備註

備註

Windows Forms控制項不支援具有透明或透明色彩的影像做為背景影像。

屬性為 true 的子控制項 RightToLeftLayout 不支援這個屬性。

給繼承者的注意事項

在衍生類別中覆 BackgroundImage 寫 屬性時,請使用基類的 BackgroundImage 屬性來擴充基底實作。 否則,您必須提供所有實作。 您不需要同時覆寫 get 屬性的 BackgroundImageset 存取子;您可以視需要只覆寫一個。

適用於

產品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

另請參閱