Control.BackgroundImageChanged イベント

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

Control.BackgroundImageChanged イベント

BackgroundImage プロパティの値が変更された場合に発生します。

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

Visual Basic (宣言)

Public Event BackgroundImageChanged As
 EventHandler

Visual Basic (使用法)

Dim instance As Control
Dim handler As EventHandler

AddHandler instance.BackgroundImageChanged, handler

C#

public event EventHandler BackgroundImageChanged

C++

public:
event EventHandler^ BackgroundImageChanged {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

J#

/** @event */
public void add_BackgroundImageChanged (EventHandler
 value)

/** @event */
public void remove_BackgroundImageChanged (EventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは BackgroundImage プロパティがプログラムの変更によって、またはユーザーとの対話によって変更された場合に発生します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

Text プロパティの値が変更されたときに実行されるイベント ハンドラのコード例を次に示します。Control クラスには、PropertyNameChanged という名前のパターンを持つメソッドがいくつかあります。これらは、対応する PropertyName の値が変更されたときに生成されます。ここで、PropertyName は対応するプロパティの名前を表します。

通貨型のデータを表示する TextBox の ForeColor を変更するコード例を次に示します。テキストを 10 進数に変換し、値が負の場合は ForeColor を Color.Red に変更し、正の場合は Color.Black に変更する例を次に示します。この例では、TextBox を格納する Form が存在している必要があります。

Visual Basic

Private Sub currencyTextBox_TextChanged(sender
 As Object, _ 
  e As EventArgs) Handles currencyTextBox.TextChanged
   Try
      ' Convert the text to a Double and determine if it is a negative
 number.
      If Double.Parse(currencyTextBox.Text)
 < 0 Then
         ' If the number is negative, display it in Red.
         currencyTextBox.ForeColor = Color.Red
      Else
         ' If the number is not negative, display it in Black.
         currencyTextBox.ForeColor = Color.Black
      End If
   Catch
      ' If there is an error, display the text using the system colors.
      currencyTextBox.ForeColor = SystemColors.ControlText
   End Try
End Sub 

C#

private void currencyTextBox_TextChanged(object
 sender, EventArgs e)
{
   try
   {
      // Convert the text to a Double and determine if it is a negative
 number.
      if(double.Parse(currencyTextBox.Text) < 0)
      {
         // If the number is negative, display it in Red.
         currencyTextBox.ForeColor = Color.Red;
      }
      else
      {
         // If the number is not negative, display it in Black.
         currencyTextBox.ForeColor = Color.Black;
      }
   }
   catch
   {
      // If there is an error, display the text using the system colors.
      currencyTextBox.ForeColor = SystemColors.ControlText;
   }
}

C++

private:
   void currencyTextBox_TextChanged( Object^ /*sender*/, EventArgs^
 /*e*/ )
   {
      try
      {
         // Convert the text to a Double and determine if it is a negative
 number.
         if ( Double::Parse( currencyTextBox->Text ) < 0
 )
         {
            // If the number is negative, display it in Red.
            currencyTextBox->ForeColor = Color::Red;
         }
         else
         {
            // If the number is not negative, display it in Black.
            currencyTextBox->ForeColor = Color::Black;
         }
      }
      catch ( Exception^ ) 
      {
         // If there is an error, display the text using the system
 colors.
         currencyTextBox->ForeColor = SystemColors::ControlText;
      }
   }

J#

private void currencyTextBox_TextChanged(Object
 sender, EventArgs e)
{
    try {
        // Convert the text to a Double and determine if it is a 
        // negative number.
        if (System.Double.Parse(currencyTextBox.get_Text()) <
 0) {
            // If the number is negative, display it in Red.
            currencyTextBox.set_ForeColor(Color.get_Red());
        }
        else {
            // If the number is not negative, display it in Black.
            currencyTextBox.set_ForeColor(Color.get_Black());
        }
    }
    catch (System.Exception exp) {
        // If there is an error, display the text using the system colors.
        currencyTextBox.set_ForeColor(SystemColors.get_ControlText());
    }
} //currencyTextBox_TextChanged

プラットフォーム

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 名前空間
Control.BackgroundImage プロパティ
Control.BackgroundImageLayout プロパティ
BackgroundImageLayoutChanged
OnBackgroundImageChanged
OnBackgroundImageLayoutChanged
Image