TextBoxBase.Modified Propriedade

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

Valor da propriedade

true se o conteúdo do controle tiver sido modificado; caso contrário, false. O padrão é false.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a TextBox seguir usa o TextChanged evento para uma TextBoxclasse derivada para determinar se o conteúdo do controle foi alterado desde que o controle foi preenchido com dados. O exemplo usa uma cadeia de caracteres para armazenar o conteúdo original do controle e compara-o com o conteúdo do TextBox para determinar se o conteúdo foi alterado. Se o conteúdo tiver sido alterado, a Modified propriedade será definida como true. Caso contrário, ele será redefinido para false. Este exemplo requer que um TextBox controle nomeado textBox1 tenha sido criado e que uma String variável nomeada originalText tenha sido criada para armazenar o texto original para o TextBox controle.

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

Comentários

Você pode usar essa propriedade para determinar se o usuário modificou o conteúdo do controle da caixa de texto. Você também pode definir essa propriedade no código para indicar que foram feitas alterações no controle da caixa de texto pelo aplicativo. Essa propriedade pode ser usada por métodos de validação e salvamento de dados para determinar se as alterações foram feitas em um controle de caixa de texto para que o conteúdo alterado possa ser validado ou salvo.

Se você alterar a Text propriedade programaticamente, a Modified propriedade será revertida para false. Isso não gera o ModifiedChanged evento.