Control.BackgroundImage プロパティ

.NET Framework クラス ライブラリ リファレンス

Control.BackgroundImage プロパティ

コントロールに表示される背景イメージを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overridable Property
 BackgroundImage As Image

Visual Basic (使用法)

Dim instance As Control
Dim value As Image

value = instance.BackgroundImage

instance.BackgroundImage = value

C#

[LocalizableAttribute(true)] 
public virtual Image BackgroundImage { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property Image^ BackgroundImage {
    Image^ get ();
    void set (Image^ value);
}

J#

/** @property */
public Image get_BackgroundImage ()

/** @property */
public void set_BackgroundImage (Image value)

JScript

public function get BackgroundImage
 () : Image

public function set BackgroundImage
 (value : Image)

プロパティ値
コントロールの背景に表示するイメージを表す Image。

解説

• グラフィック イメージをコントロールに配置するには、BackgroundImage プロパティを使用します。

メモ
半透明の色または透過色のイメージは、Windows フォーム コントロールでは背景イメージのようにはサポートされません。 RightToLeftLayout プロパティが true の子コントロールでは、このプロパティはサポートされません。

継承時の注意 派生クラスで BackgroundImage プロパティをオーバーライドする場合は、基本クラスの BackgroundImage プロパティを使用して、基本の実装を拡張します。それ以外の場合は、すべての実装を提供する必要があります。BackgroundImage プロパティの get アクセサと set アクセサの両方をオーバーライドする必要はありません。必要に応じて 1 つのアクセサだけをオーバーライドできます。

使用例

フォームに Button を追加し、共通プロパティの一部を設定するコード例を次に示します。この例では、ボタンをフォームの右下隅に固定することにより、フォームのサイズが変更されても、相対的な位置関係が維持されるようにしています。次に、BackgroundImage を設定して、ボタンを Image と同じサイズに変更します。この例では、TabStop を true に設定し、TabIndex プロパティを設定しています。最後に、ボタンの Click イベントを処理するイベント ハンドラを追加します。この例では、imageList1 という名前の ImageList が存在している必要があります。

Visual Basic

' 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

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

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

J#

// 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.set_Anchor(AnchorStyles.Bottom | AnchorStyles.Right);
    // Assign a background image.
    button1.set_BackgroundImage(imageList1.get_Images().get_Item(0));
    // Specify the layout style of the background image. Tile is the
 
    // default.
    button1.set_BackgroundImageLayout(ImageLayout.Center);
    // Make the button the same size as the image.
    button1.set_Size(button1.get_BackgroundImage().get_Size());
    // Set the button's TabIndex and TabStop properties.
    button1.set_TabIndex(1);
    button1.set_TabStop(true);
    // Add a delegate to handle the Click event.
    button1.add_Click(new System.EventHandler(this.button1_Click));
    // Add the button to the form.
    this.get_Controls().Add(button1);
} //AddMyButton

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
Image
BackgroundImageChanged
BackgroundImageLayout
BackgroundImageLayoutChanged
OnBackgroundImageChanged
OnBackgroundImageLayoutChanged