Control.BackgroundImage 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

Control.cs

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

public:
 virtual property System::Drawing::Image ^ BackgroundImage { System::Drawing::Image ^ get(); void set(System::Drawing::Image ^ value); };

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

member this.BackgroundImage : System.Drawing.Image with get, set

Public Overridable Property BackgroundImage As Image

屬性值

Image

一個 Image 代表要在控制項背景顯示的影像。

範例

以下程式碼範例將 a Button 加入表單，並設定其一些常見屬性。 範例中將按鈕固定在表單的右下角，以保持表單調整大小時的相對位置。 接著它設定 ， BackgroundImage 並將按鈕調整到和 Image. 相同的大小。 範例接著設定 到 TabStop 並true設定屬性。TabIndex 最後，它新增了一個事件處理程序來處理 Click 按鈕事件。 此範例要求你有一個 ImageList 名為 imageList1的 。

   // 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 = gcnew Button;

      // Anchor the button to the bottom right corner of the form
      button1->Anchor = static_cast<AnchorStyles>(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 += gcnew System::EventHandler( this, &Form1::button1_Click );

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

// 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);
}

' Add a button to a form and set some of its common properties.
Private Sub AddMyButton()
   ' Create a button and add it to the form.
   Dim button1 As New Button()
   
   ' Anchor the button to the bottom right corner of the form
   button1.Anchor = AnchorStyles.Bottom Or 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.
   AddHandler button1.Click, AddressOf Me.button1_Click
   
   ' Add the button to the form.
   Me.Controls.Add(button1)
End Sub

備註

• 利用這個 BackgroundImage 屬性將圖形影像放到控制項上。

備註

半透明或透明顏色的圖片不支援 Windows 表單控制項作為背景圖片。

此屬性不被子控項支援，而子 RightToLeftLayout 控項的子控項為 true。

給繼承者的注意事項

在導出類別中覆寫該 BackgroundImage 屬性時，請使用基底類別的 BackgroundImage 特性來擴充基底實作。 否則，你必須提供所有的實作。 你不必同時覆寫get該財產的setBackgroundImage附屬裝置;如果需要，你只能覆蓋其中一項。

另請參閱

• Image
• BackgroundImageChanged
• BackgroundImageLayout
• BackgroundImageLayoutChanged
• OnBackgroundImageChanged(EventArgs)
• OnBackgroundImageLayoutChanged(EventArgs)