TextBoxBase.Modified Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur qui indique que le contrôle zone de texte a été modifié par l'utilisateur depuis la création du contrôle ou la précédente définition du contenu du contrôle.

public:
 property bool Modified { bool get(); void set(bool value); };

[System.ComponentModel.Browsable(false)]
public bool Modified { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Modified : bool with get, set

Public Property Modified As Boolean

Valeur de propriété

Boolean

true si le contenu du contrôle a été modifié ; sinon, false. La valeur par défaut est false.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant utilise l’événement TextChanged pour une TextBoxclasse dérivée , pour déterminer si le contenu du TextBox contrôle a changé depuis que le contrôle a été rempli de données. L’exemple utilise une chaîne pour stocker le contenu d’origine du contrôle et le compare au contenu du TextBox pour déterminer si le contenu a changé. Si le contenu a changé, la Modified propriété a la truevaleur . Sinon, il est réinitialisé à false. Cet exemple nécessite qu’un TextBox contrôle nommé textBox1 ait été créé et qu’une String variable nommée originalText ait été créée pour stocker le texte d’origine du TextBox contrôle.

private:
   void TextBox1_TextChanged( Object^ sender, EventArgs^ e )
   {
      /* Check to see if the change made does not return the
         control to its original state. */
      if ( originalText != textBox1->Text )
      {
         // Set the Modified property to true to reflect the change.
         textBox1->Modified = true;
      }
      else
      {
         // Contents of textBox1 have not changed, reset the Modified property.
         textBox1->Modified = false;
      }
   }

private void TextBox1_TextChanged(object sender, EventArgs e)
 {
    /* Check to see if the change made does not return the
       control to its original state. */
    if (originalText != textBox1.Text)
       // Set the Modified property to true to reflect the change.
       textBox1.Modified = true;
    else
       // Contents of textBox1 have not changed, reset the Modified property.
       textBox1.Modified = false;
 }

Private Sub TextBox1_TextChanged(sender As Object, e As EventArgs)
    ' Check to see if the change made does not return the
    ' control to its original state. 
    If originalText <> textBox1.Text Then
        ' Set the Modified property to true to reflect the change.
        textBox1.Modified = True
        ' Contents of textBox1 have not changed, reset the Modified property.
    Else
        textBox1.Modified = False
    End If
End Sub

Remarques

Vous pouvez utiliser cette propriété pour déterminer si l’utilisateur a modifié le contenu du contrôle de zone de texte. Vous pouvez également définir cette propriété dans le code pour indiquer que des modifications ont été apportées au contrôle de zone de texte par l’application. Cette propriété peut être utilisée par des méthodes de validation et d’enregistrement des données pour déterminer si des modifications ont été apportées dans un contrôle de zone de texte afin que le contenu modifié puisse être validé ou enregistré.

Si vous modifiez la Text propriété par programmation, la Modified propriété revient à false. Cela ne déclenche pas l’événement ModifiedChanged .