Occurs when the Text property value changes.

[Visual Basic]
Public Event TextChanged As EventHandler
[C#]
public event EventHandler TextChanged;
[C++]
public: __event EventHandler* TextChanged;

[JScript] In JScript, you can handle the events defined by a class, but you cannot define your own.

Event Data

The event handler receives an argument of type EventArgs.

Remarks

This event is raised if the Text property is changed by either a programmatic modification or user interaction.

For more information about handling events, see Consuming Events.

Example

[Visual Basic, C#, C++] The following example changes the ForeColor of a TextBox displaying currency data. The example converts the text to a decimal number and changes the ForeColor to Color.Red if the number is negative and to Color.Black if the number is positive. This example assumes you have a Form that contains a TextBox.

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

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Control Class | Control Members | System.Windows.Forms Namespace | OnTextChanged | Text