Control::TextChanged Event


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Occurs when the Text property value changes.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

event EventHandler^ TextChanged {
	void add(EventHandler^ value);
	void remove(EventHandler^ value);

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 Handling and Raising Events.

The following code 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 requires that you have a Form that contains a TextBox.

   void currencyTextBox_TextChanged( Object^ /*sender*/, EventArgs^ /*e*/ )
         // 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;
            // 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;

.NET Framework
Available since 1.1
Return to top